[OpenStack-docs] Final users docs freeze

Andreas Jaeger aj at suse.com
Tue Nov 11 20:28:25 UTC 2014


On 11/04/2014 04:15 PM, Cloudwatt - François Bureau wrote:
> Hello Docs team,
> 
> I am very sorry because I was very late at the documentation design session so I was not able to discuss about this subject.
> 
> I am involved into french documentation (as french coordinator too) and working for a public cloud company (Cloudwatt).
> 
> Because my company is in France and because we try to upstream a lot of changes we are doing, we try to be active into the translation initiative. For example, we have made a lot of contributions on the Horizon interface (fixes, improvements and translations). 
> 
> For documentation we wanted to translate the documentation for our own use and to upstream to the community all our works.
> 
> But unfortunately the documentation is moving to much and we had different issue about upstreaming our works. Because of that, we had to make a fork and to create our own doc. 
> 
> This not a nice situation for us because it is a big effort for maintaining our work and we not really contribute on the documentation and this is not what we are looking for.
> 
> Do you thing it could be possible to freeze the "end users documentations" (User guides, API Guides, all docs dedicated for the users which going to use the end product) ?
> 
> It could be updated every 6 month for each OpenStack Release.
> 
> At the end of the session, I have discussed with Anne and Daisy about that and they told me to send an e-mail about this subject :)
> 
> Thanks a lot for your feedback !

This is difficult. We moved last year or so to have these books updated
constantly, so freezing them would increase our work since we would need
to backport fixes.

Still, I think we should discuss this on a book by book basis and decide
what to do - but first we would need to update our translation tools so
that they handle stable branches.

Transifex right now does not allow us to easily update translations for
stable branches. Once we switched to Zanata, this is something I'd like
to see working - and once we have this working properly, we should look
at the manuals and decide how to do this,

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF:Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the OpenStack-docs mailing list