[OpenStack-docs] No document string freeze on stable branch?

Matt Kassawara mkassawara at gmail.com
Mon Oct 10 22:56:17 UTC 2016


For a moment, let's assume Newton isn't released yet because
openstack-manuals hasn't branched yet. I'm working on some significant
beneficial changes to the networking guide that resolve a number of issues
we probably should have addressed a while ago... ideally before the release
of Mitaka... but I couldn't accomplish it and no one else contributes to
this particular content. The networking guide isn't continuously published.
When my changes to it merge in master, they are essentially invisible to
operators until the next release. Operators often run a stable release or
two behind master. Thus, only merging in master (which becomes the next
release) limits the audience of the changes. Backporting such changes to
the prior release (if they apply) makes them visible to a wider audience.
Furthermore, this particular patch resolves a number of issues with the
Mitaka content. Finally, doesn't the same issue of translation apply to
continuous-release content such as the admin guide?

On Mon, Oct 10, 2016 at 4:22 PM, Akihiro Motoki <amotoki at gmail.com> wrote:

> Correction.
>
> 2016-10-11 7:20 GMT+09:00 Akihiro Motoki <amotoki at gmail.com>:
>
>> Does the openstack-manuals project allow a big refactoring in **stable**
>> branches?
>>
>> I saw a big refactoring on the networking guide was merged in the master
>> branch
>> and it was backported into stable/mitaka branch.
>>
>> As a result of the backport, 25% of Japanese Mitaka Networking Guide
>> translation.
>>
>
> As a result of the backport, 25% of Japanese Mitaka Networking Guide
> translation was lost.
>
>
>> I was really shocked that such thing happened in a stable branch.
>> If the project allows such backport, translators will easily lose their
>> translation
>> and it implicitly means the project suggests not to translate it.
>>
>> I would like to know the policy of the docs stable branch maintenance.
>>
>> Akihiro
>>
>>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20161010/62b7d6cf/attachment.html>


More information about the OpenStack-docs mailing list