<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">Hello,<br>
<br>
Doug Hellmann wrote on 8/2/2017 12:43 AM:<br>
</div>
<blockquote type="cite"
cite="mid:33D9AF7D-DF45-4AB6-BF7B-58E9D4C2B122@doughellmann.com">
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
[resending to the lists]
<div class=""><br class="">
<div>
<blockquote type="cite" class="">
<div class="">On Aug 1, 2017, at 10:55 AM, Doug Hellmann
<<a href="mailto:doug@doughellmann.com" class=""
moz-do-not-send="true">doug@doughellmann.com</a>>
wrote:</div>
<br class="Apple-interchange-newline">
<div class=""><span style="font-family:
BitstreamVeraSansMono-Roman; font-size: 13px;
font-style: normal; font-variant-caps: normal;
font-weight: normal; letter-spacing: normal; text-align:
start; text-indent: 0px; text-transform: none;
white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">Excerpts from Andreas
Jaeger's message of 2017-08-01 08:57:09 +0200:</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<blockquote type="cite" style="font-family:
BitstreamVeraSansMono-Roman; font-size: 13px;
font-style: normal; font-variant-caps: normal;
font-weight: normal; letter-spacing: normal; orphans:
auto; text-align: start; text-indent: 0px;
text-transform: none; white-space: normal; widows: auto;
word-spacing: 0px; -webkit-text-size-adjust: auto;
-webkit-text-stroke-width: 0px;" class="">On 2017-07-31
22:46, Doug Hellmann wrote:<br class="">
<blockquote type="cite" class="">Excerpts from Ian Y.
Choi's message of 2017-08-01 03:16:09 +0900:<br
class="">
<blockquote type="cite" class="">[...]<br class="">
2. Draft index page for translated documents was
also removed<br class="">
<br class="">
Previously, Docs team maintained draft documents for
the master branch<span class="Apple-converted-space"> </span><br
class="">
(which will be the stable branch<br class="">
after the official release and the document stables)
on<span class="Apple-converted-space"> </span><br
class="">
<a
href="https://docs.openstack.org/draft/draft-index.html"
class="" moz-do-not-send="true">https://docs.openstack.org/draft/draft-index.html</a>
page.<br class="">
It also contained translated draft documents and
I18n team accessed the<span
class="Apple-converted-space"> </span><br class="">
page to see whether translated documents<br class="">
render well or not, and also review translated
strings.<br class="">
<br class="">
I did not notice when I saw the spec [1], but
recently, I noticed that<span
class="Apple-converted-space"> </span><br class="">
the the draft-index.html page was deprecated<br
class="">
by [next-release-name]/index.haml (e.g.,<span
class="Apple-converted-space"> </span><br class="">
<a href="https://docs.openstack.org/pike/index.html"
class="" moz-do-not-send="true">https://docs.openstack.org/pike/index.html</a>
) [4].<br class="">
<br class="">
Since I18n team encourages translation review for
the better quality of<span
class="Apple-converted-space"> </span><br class="">
translations, it is a good idea to see<br class="">
draft documents before language landing pages have
the link to fully<span class="Apple-converted-space"> </span><br
class="">
translated and reviewed documents.<br class="">
</blockquote>
<br class="">
Is it possible to see the draft of a translation by
reviewing the<br class="">
output of the job that proposes the patch containing
the translated<br class="">
text?<br class="">
</blockquote>
<br class="">
Currently not, it needs publishing to docs-draft and a
way to access the<br class="">
multiple documents. Note this needs handling for both
openstack-manuals<br class="">
and project repos like neutron (networking-guide).<br
class="">
</blockquote>
<br style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">Could we make it work that
way? I understand why we need a separate</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">review step for the
translations, but not why we need a separate</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">copy of the docs published
outside of the context of a job in order</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">to perform that review.
(This is probably just me not understanding</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">how a tool works.)</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
</div>
</blockquote>
</div>
</div>
</blockquote>
<br>
It would be much nice if the job also supports the publication for
translated documents,<br>
assuming that the translated document build work should not
interfere with the main documentation build steps.<br>
<br>
But for general perspective, if the target of translation is not all
of documents in openstack-manuals,<br>
we might need to analyze whether inclusion of translated document
build jobs is better or not.<br>
<br>
<blockquote type="cite"
cite="mid:33D9AF7D-DF45-4AB6-BF7B-58E9D4C2B122@doughellmann.com">
<div class="">
<div>
<blockquote type="cite" class="">
<div class=""><br style="font-family:
BitstreamVeraSansMono-Roman; font-size: 13px;
font-style: normal; font-variant-caps: normal;
font-weight: normal; letter-spacing: normal; text-align:
start; text-indent: 0px; text-transform: none;
white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<blockquote type="cite" style="font-family:
BitstreamVeraSansMono-Roman; font-size: 13px;
font-style: normal; font-variant-caps: normal;
font-weight: normal; letter-spacing: normal; orphans:
auto; text-align: start; text-indent: 0px;
text-transform: none; white-space: normal; widows: auto;
word-spacing: 0px; -webkit-text-size-adjust: auto;
-webkit-text-stroke-width: 0px;" class=""><br class="">
<blockquote type="cite" class="">
<blockquote type="cite" class="">Motoki-san proposed
an idea of translation status support using an yaml<span
class="Apple-converted-space"> </span><br class="">
file in openstack-manuals [5],<br class="">
and I would like to discuss with I18n team how we
deal with the change<span
class="Apple-converted-space"> </span><br class="">
of draft index page.<br class="">
</blockquote>
<br class="">
How would that flag or information be used?<br
class="">
<br class="">
</blockquote>
<br class="">
WE could just have the link to it added - dependent on
the flag - to either:<br class="">
* language index<br class="">
* draft index<br class="">
</blockquote>
<br style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">It seems like we want a
list of languages for which there are</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">translations for a given
set of docs. We could use that to populate</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">templates in a few
different ways (link from the English version</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">to the other languages,
link from a $language landing page to all</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">of the guides in that
language, etc.).</span><br style="font-family:
BitstreamVeraSansMono-Roman; font-size: 13px;
font-style: normal; font-variant-caps: normal;
font-weight: normal; letter-spacing: normal; text-align:
start; text-indent: 0px; text-transform: none;
white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<br style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">I can advise someone on how
to add those features, if we have a</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">volunteer.</span><br
style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<br style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px;" class="">
<span style="font-family: BitstreamVeraSansMono-Roman;
font-size: 13px; font-style: normal; font-variant-caps:
normal; font-weight: normal; letter-spacing: normal;
text-align: start; text-indent: 0px; text-transform:
none; white-space: normal; word-spacing: 0px;
-webkit-text-stroke-width: 0px; float: none; display:
inline !important;" class="">Doug</span></div>
</blockquote>
</div>
<br class="">
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
OpenStack-I18n mailing list
<a class="moz-txt-link-abbreviated" href="mailto:OpenStack-I18n@lists.openstack.org">OpenStack-I18n@lists.openstack.org</a>
<a class="moz-txt-link-freetext" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n</a>
</pre>
</blockquote>
<p><br>
</p>
</body>
</html>