<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Apr 9, 2015 at 8:34 AM, Ying Chun Guo <span dir="ltr"><<a href="mailto:guoyingc@cn.ibm.com" target="_blank">guoyingc@cn.ibm.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div>
<p><font face="sans-serif">I did an assessment of the string changes affected by this action,</font><br>
<font face="sans-serif">in order to evaluate the extra workload for translators to translate the new versions, </font><br>
<font face="sans-serif">assuming the old version of DocBook pot files are 100% completed translation.</font><br>
<br>
<font face="sans-serif">I download the English source files of these following resources from Transifex:</font><br>
<font face="sans-serif">openstack-manuals-i18n.user-guides ( RST format )</font><br>
<font face="sans-serif">openstack-manuals-i18n.user-guide ( DocBook format )</font><br>
<font face="sans-serif">openstack-manuals-i18n.user-guide-admin ( DocBook format )</font><br>
<br>
<font face="sans-serif">openstack-manuals-i18n.user-guides is the new RST document, which is a combination of openstack-manuals-i18n.user-guide </font><br>
<font face="sans-serif">and openstack-manuals-i18n.user-guide-admin, including new contents and changes.</font><br>
<br>
<font face="sans-serif">I found three types of changes:</font><br>
<font face="sans-serif">1. all strings including XML markups are changed, XML markups being removed, replacing with RST format characters.</font><br>
<font face="sans-serif">e.g.</font><br>
<font face="Courier New">"To perform a hard reboot, pass the <parameter>--hard</parameter> parameter, "</font><br>
<font face="Courier New">"as follows:"</font><br>
<font face="Courier New">is changed to:</font><br>
<font face="Courier New">"To perform a </font><font face="Courier New">hard reboot, pass the ``--hard`` parameter, as follows::"</font><br>
<br>
<font face="sans-serif">2. some strings are added ** and ** as prefix and suffix.</font><br>
<font face="sans-serif">e.g.</font><br>
<font face="Courier New">"Removal or addition of segment objects"</font><br>
<font face="Courier New">is changed to</font><br>
<font face="SimSun">"**Removal or addition of segment objects**"</font><br>
<br>
<font face="sans-serif">3. all strings ending with ":" are changed, ending with "::" instead.</font><br>
<font face="Courier New">e.g.</font><br>
<font face="Courier New">"To perform an instance reboot into rescue mode, run the following command:"</font><br>
<font face="Courier New">is changed to</font><br>
<font face="Courier New">"To perform an instance reboot into rescue mode, run the following command::"</font><br>
<br>
<font face="Courier New">Then I calculated the numbers of strings.</font><br>
<br>
<font face="sans-serif">openstack-manuals-i18n.user-guide</font><font face="Courier New"> (old docbook ) has 2005 strings, including</font><br>
<font face="Courier New">779 (39%) strings exactly moved to new RST pot, </font><br>
<font face="Courier New">1226 (61%) strings which are either changed (mostly) or removed.</font><br>
<br>
<font face="sans-serif">openstack-manuals-i18n.user-guide-admin</font><font face="Courier New"> (old docbook ) has 653 strings, including</font><br>
<font face="Courier New">277 strings (42%) exactly moved to RST pot,</font><br>
<font face="Courier New">376 strings (58%) which are either changed (mostly) or removed.</font><br>
<br>
<font face="sans-serif">openstack-manuals-i18n.user-guides</font><font face="Courier New"> ( new RST ) has 2892 strings, including 779 (27%) strings exactly </font><br>
<font face="Courier New">matched strings in user-guide, 277 (10%) strings exactly matched strings in user-guide-admin, </font><br>
<font face="Courier New">and 1861 (64%) strings matched nothing.</font><br>
<br>
<font face="Courier New">That means, if translators have 100% completed </font><font face="sans-serif">openstack-manuals-i18n.user-guide</font><font face="Courier New"> and </font><font face="sans-serif">openstack-manuals-i18n.user-guide-admin</font><font face="Courier New"> translation,</font><br>
<font face="Courier New">the translation completion rate for the new RST file </font><font face="Courier New">is 36%.</font><br>
<br>
<font face="sans-serif">After a deep dive of the new RST pot file, there are 196 strings ending with double colon and 70 strings with prefix ** and suffix **.</font><br>
<font face="sans-serif">If we use scripts to change those strings and make them exactly match, the auto completion rate could be improved from 36% to 45%.</font><br>
<br>
<font face="sans-serif">As to the XML markup changes, they are quite difficult to auto match.</font><br>
<font face="sans-serif">openstack-manuals-i18n.user-guide has 25% strings including XML markups, and </font><br>
<font face="sans-serif">openstack-manuals-i18n.user-guide-admin</font><font face="sans-serif"> has 33% strings including XML markups.</font><br>
<font face="sans-serif">We might have to change manually.</font><br>
<br>
<font face="sans-serif">But, no team has big progress with user-guide-admin and user-guide</font><font face="sans-serif"> translation, except Japanese team.</font><br>
<font face="sans-serif">So I think, the tolerance to manually change the translations are acceptable. </font><br>
<br></p></div></blockquote><div>Thanks for this thorough analysis. This information is extremely helpful.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><p>
<font face="sans-serif">BTW, my analysis has nothing with the translators feeling to RST markups.</font><br>
<font face="sans-serif">In my mind, while I translate DocBook, I have to copy XML markups.</font><br>
<font face="sans-serif">The same happen to me if I translate RST books. I have to copy RST markups.</font><br>
<font face="sans-serif">I just need to understand which words are RST markups and should not be translated.</font><br>
<font face="sans-serif">Maybe doc team could give us a list of these special RST markups for us to reference.</font></p></div></blockquote><div><br></div><div>Agreed. Andreas has completely gone through our conventions and indicated the equivalent markups in DocBook and RST.</div><div><br></div><div><a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions">https://wiki.openstack.org/wiki/Documentation/Markup_conventions</a><br></div><div><br></div><div>For example, <filename>nova.conf</filename> in DocBook becomes :file:`nova.conf` in RST, as shown in this section:</div><div><a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions#File_name_or_path">https://wiki.openstack.org/wiki/Documentation/Markup_conventions#File_name_or_path</a><br></div><div><br></div><div>Do you have a list of "ignored" markup already? We could take a look and see if a mapping is fairly straightforward based on what we have.</div><div><br></div><div>Thanks,</div><div>Anne</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><p><br>
<br>
<font face="sans-serif">@ translation teams, the attachment is the strings in the new RST pot file which cannot find an existing matched string.</font><br>
<font face="sans-serif">You may take a look at it and let us know your feeling is.</font><br>
<br>
<font face="sans-serif">Thank you.</font><br>
<br>
<font face="sans-serif">Best regards<br>
Ying Chun Guo (Daisy)</font><br>
<br>
<i>(See attached file: new strings all.po)</i><font face="sans-serif"><br>
</font><br>
<br>
<tt><font>Andreas Jaeger <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>> wrote on 2015/04/09 14:53:27:<br>
<br>
> From: Andreas Jaeger <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></font></tt><br>
<tt><font>> To: "<a href="mailto:openstack-i18n@lists.openstack.org" target="_blank">openstack-i18n@lists.openstack.org</a>" <<a href="mailto:openstack-i18n@lists.openstack.org" target="_blank">openstack-i18n@lists.openstack.org</a>></font></tt><br>
<tt><font>> Cc: Anne Gentle <<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></font></tt><br>
<tt><font>> Date: 2015/04/09 14:53</font></tt><br>
<tt><font>> Subject: [Openstack-i18n] User Guides Changes</font></tt><br>
<tt><font></font></tt></p><div><div class="h5"><tt><font>> <br>
> The two User Guide, Admin User Guide and End User Guide, have been <br>
> converted from Docbook XML to RST. The conversion shouldn't have changed <br>
> sentences but since markup has changed, strings for translation have <br>
> changed as well.<br>
> <br>
> I've tried to merge the strings in transifex, so please have a look - <br>
> and update the guides.<br>
> <br>
> I've marked the old guides as read-only in transifex, so that you cannot <br>
> change them anymore but still can use them as reference. The <br>
> documentation team will remove the old-guides from their project today.<br>
> <br>
> Transifex resources:<br>
> Old End User Guide:<br>
> <a href="https://www.transifex.com/projects/p/openstack-manuals-i18n/" target="_blank">https://www.transifex.com/projects/p/openstack-manuals-i18n/</a><br>
> resource/user-guide/<br>
> <br>
> Old Admin User Guide:<br>
> <a href="https://www.transifex.com/projects/p/openstack-manuals-i18n/" target="_blank">https://www.transifex.com/projects/p/openstack-manuals-i18n/</a><br>
> resource/user-guide-admin/<br>
> <br>
> New RST User Guides (single resource for both books):<br>
> <a href="https://www.transifex.com/projects/p/openstack-manuals-i18n/" target="_blank">https://www.transifex.com/projects/p/openstack-manuals-i18n/</a><br>
> resource/user-guides/<br>
> <br>
> If there's anything else I can do, please speak up,<br>
> <br>
> Andreas<br>
> -- <br>
> Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
> SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
> GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
> Graham Norton, HRB 21284 (AG Nürnberg)<br>
> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
> <br>
> <br></font></tt></div></div><tt><font>
> _______________________________________________<br>
> Openstack-i18n mailing list<br>
> <a href="mailto:Openstack-i18n@lists.openstack.org" target="_blank">Openstack-i18n@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n</a><br>
</font></tt><p></p></div>
</blockquote></div><br></div></div>