kicad-doc-devs team mailing list archive

[Jon Evans <jon@xxxxxxxxxxxxx>]

How often would we actually cherry-pick stuff back, though?  Isn't the
point of stable branches that features don't change very much (if at all),
and therefore the doc wouldn't need to change?

On Fri, Jan 10, 2020 at 10:57 AM Wayne Stambaugh <stambaughw@xxxxxxxxx>
wrote:

>
> On 1/10/20 2:46 AM, Marco Ciampa wrote:
> > On Thu, Jan 09, 2020 at 08:11:38PM -0500, Jon Evans wrote:
> >> My view is that the development team (including those working on code
> and
> >> those working on documentation, sometimes the same people and sometimes
> >> different) need a place to stage documentation for future releases.
> >> I think KiCad will almost always be in a situation where the development
> >> version *could* have different features than the released version, and
> it
> >> would be good to have "nightly builds" of the docs available so that we
> >> don't delay writing and checking documentation until the very last
> minute.
> >>
> >> But Nick's point is also good, in that this takes more effort from
> >> volunteers.
> >
> > Well, IMHO that's not completely true.
> >
> > Translators could be more than happy to have a stable documentation base
> > to translate, instead of a moving target.
> >
> > Morover having a stable branch and master and/or many different feature
> > branches could be even an improvement for devs, since they have to add
> > documentation features over a pretty stable branch and that greatly
> > semplify merge and conflicts resolution.
> >
> > The translation effort IMHO must not start on dev branches but only on
> > the stable branch.
> >
> > In this way all are happy: translators, users and devs.
> > And also it is less, not more, work in general.
> >
> > What do you think?
> >
>
> The bottom line as always is manpower.  The question really has been and
> still is do we have the manpower to support both stable and development
> documentation branches?  Having separate branches tends to create more
> work for the lead doc dev team due to the necessity of cherry-picking
> changes back to the stable branch as applicable.  I'm willing to give
> this a try if we think we have the manpower to support it.  I suppose if
> the stable branch isn't maintained, we can always drop it.
>
> Cheers,
>
> Wayne
>
> --
> Mailing list: https://launchpad.net/~kicad-doc-devs
> Post to     : kicad-doc-devs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-doc-devs
> More help   : https://help.launchpad.net/ListHelp
>