[OpenStack-I18n] [OpenStack-docs] Summary of how I18n affects with doc-migration
Andreas Jaeger
aj at suse.com
Tue Aug 1 06:57:09 UTC 2017
On 2017-07-31 22:46, Doug Hellmann wrote:
> Excerpts from Ian Y. Choi's message of 2017-08-01 03:16:09 +0900:
>> [...]
>> 2. Draft index page for translated documents was also removed
>>
>> Previously, Docs team maintained draft documents for the master branch
>> (which will be the stable branch
>> after the official release and the document stables) on
>> https://docs.openstack.org/draft/draft-index.html page.
>> It also contained translated draft documents and I18n team accessed the
>> page to see whether translated documents
>> render well or not, and also review translated strings.
>>
>> I did not notice when I saw the spec [1], but recently, I noticed that
>> the the draft-index.html page was deprecated
>> by [next-release-name]/index.haml (e.g.,
>> https://docs.openstack.org/pike/index.html ) [4].
>>
>> Since I18n team encourages translation review for the better quality of
>> translations, it is a good idea to see
>> draft documents before language landing pages have the link to fully
>> translated and reviewed documents.
>
> Is it possible to see the draft of a translation by reviewing the
> output of the job that proposes the patch containing the translated
> text?
Currently not, it needs publishing to docs-draft and a way to access the
multiple documents. Note this needs handling for both openstack-manuals
and project repos like neutron (networking-guide).
>> Motoki-san proposed an idea of translation status support using an yaml
>> file in openstack-manuals [5],
>> and I would like to discuss with I18n team how we deal with the change
>> of draft index page.
>
> How would that flag or information be used?
>
WE could just have the link to it added - dependent on the flag - to either:
* language index
* draft index
Andreas
--
Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
GF: Felix Imendörffer, Jane Smithard, Graham Norton,
HRB 21284 (AG Nürnberg)
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126
More information about the OpenStack-I18n
mailing list