Tom, these files could be kept in the currently proposed Sources folder within the Training Guides folder. Would that alleviate your concerns? However, these devref files contain valuable install information that could be included in other guides. I could analyze them further to see how they could be appropriated. If there's no significant value that would make them xi:includable for other guides, then they could be hosted in the Training folder. The ultimate intent is to make them accessible and part of the OS Docs family. I would think that translators would focus only on the files that are particular to a specific guide and not the entire Common folder. <span></span>I'll respond to Anne's comments shortly. - Nermina <br>
<br>On Monday, October 28, 2013, Tom Fifield  wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 29/10/13 11:45, Nermina Miller wrote:<br>
> - Add the entire batch of the devref files to the Common folder<br>
> (subfolder Training) so the files can be made available to the other<br>
> guides in the long term. (Why all? Because the py script updates and<br>
> converts them ALL at the same time. You may already know this but it<br>
> helps to explain the need for such a large batch.)<br>
<br>
This is a problem for translation.<br>
<br>
The common directory is already over 50,000 words - putting it beyond<br>
the reach of all but our most dedicated language teams. I've actually<br>
had a plan to try and move some material that really isn't 'common' out<br>
of there for this reason.<br>
<br>
Using common as a dumping ground will essentially prevent translation of<br>
the best parts of our manuals - those that have been lovingly crafted<br>
for use in several documents. Translators should be able to make maximum<br>
impact by translating items in common, but that's not true today.<br>
<br>
For a real example, take the install guide - it's just 18k words, a nice<br>
small guide and easy to translate. There's actually some good progress<br>
being made in several languages (more than 20% in Russian and Chinese).<br>
However, it also has some content from common, and working with the 50k<br>
mess to get a complete document out is pretty annoying.<br>
<br>
In short: please don't put stuff in common unless it is truly used by<br>
multiple documents, and especially don't use it as a dumping ground for<br>
large amounts of content.<br>
<br>
<br>
<br>
Regards,<br>
<br>
<br>
Tom<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="javascript:;" onclick="_e(event, 'cvml', 'Openstack-docs@lists.openstack.org')">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote><br><br>-- <br><div dir="ltr">Thank you!<div><br></div><div>Nermina Miller</div><div>Tech Writer and Editor</div></div><br>