On 6/10/22 11:30, Jérémie Tarot wrote:

What about splitting out the docs in dedicated packages like many other
projects?

We could have linuxcnc-doc for english and then linuxcnc-doc-$lang for
translations. This in turn would allow us to build docs translation
packages at will.

In the future, this will also avoid installing 1Gb of 27 translations docs!

The English docs & each of the translated docs is already each in a separate package. Users can choose which, if any, to install.

Or do you mean to split the repo, so the docs and the code are in different git repositories? I'm opposed to that idea for a couple of reasons:

1. Having the code & the docs live together in one repo makes it easier to update both when either changes (ie, in the same PR), and simplifies release management.

2. Our "halcompile" infrastructure puts the code and the manpage for that code in the same file, so that infrastructure would have to be changed or discontinued.


--
Sebastian Kuzminsky


_______________________________________________
Emc-developers mailing list
Emc-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/emc-developers

Reply via email to