<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div>Hi Ian,</div><div>You show us the Indonesian translations at the [1][2][3][4][5].</div><div>Thank you very much</div><div>/Suhartono</div><div><br></div><div>[1] <a href="https://www.openstack.org/user-survey/survey-2018/landing?lang=id_ID">https://www.openstack.org/user-survey/survey-2018/landing?lang=id_ID</a></div><div>[2] <a href="https://www.openstack.org/edge-computing/cloud-edge-computing-beyond-the-data-center">https://www.openstack.org/edge-computing/cloud-edge-computing-beyond-the-data-center</a></div><div>[3] <a href="https://www.openstack.org/containers/leveraging-containers-and-openstack/">https://www.openstack.org/containers/leveraging-containers-and-openstack/</a></div><div>[4] <a href="https://docs.openstack.org/id/">https://docs.openstack.org/id/</a></div><div>[5] <a href="https://docs.openstack.org/i18n/latest/id/release_management.html">https://docs.openstack.org/i18n/latest/id/release_management.html</a> </div></div></div></div></div></div></div></div><br><div class="gmail_quote"><div dir="ltr">Pada tanggal Kam, 20 Sep 2018 pukul 11.09 Ian Y. Choi <<a href="mailto:ianyrchoi@gmail.com">ianyrchoi@gmail.com</a>> menulis:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thanks a lot for nice summary on Docs part especially!<br>
I would like to add an additional summary with more context from I18n<br>
perspective.<br>
<br>
Note: I mainly participated in Docs/I18n discussion only on Monday & Tuesday<br>
(not available during Wed - Fri due to conflicts with other work in my<br>
country),<br>
and my summary would be different from current I18n PTL if he have<br>
parcipated in Stein PTG,<br>
but I would like to summarize as I18n ex-PTL (Ocata, Pike) and as one of<br>
active partcipants in Docs/I18n discussion.<br>
<br>
Documentation & I18n teams started to have collaborative discussions<br>
from Pike PTG.<br>
Following with Queens & Rocky cycle, I am so happy that Documentation &<br>
I18n teams had tight collaboration<br>
again at Stein PTG for horizontal discussion with sharing issues and<br>
tight collaboration.<br>
<br>
More details for I18n issues are available at the bottom part ("i18n<br>
Topics") in:<br>
<a href="https://etherpad.openstack.org/p/docs-i18n-ptg-stein" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/docs-i18n-ptg-stein</a><br>
<br>
PROJECT DOCUMENTATION TRANSLATION SUPPORT<br>
<br>
This year, I18n team actively started to support project documentation<br>
translation [1] and there had progress<br>
on defining documentation translation targets, generatepot infra jobs,<br>
and translation sync on from project repositories to<br>
Zanata for translation sources & from Zanata to project repositories for<br>
translated strings.<br>
[2] and [3] are parts of work I18n team did on previous cycle, and the<br>
final part would be how to support translated documentation publication<br>
aligned with Documentation team, since PDF support implementation is<br>
also related with how to publish PDF files for project repositories.<br>
<br>
Although there were so nice discussion during last Vancouver Summit [4],<br>
more generic idea on infra side how to better support translated<br>
documentation & PDF builds and translation<br>
would be needed after some changes on Project Testing Interface which is<br>
used for project documentation builds [5].<br>
<br>
[6] is a nice summary from Doug (really appreciated!) for the direction<br>
and plans on PDF and translation builds<br>
by making use of openstack-tox-docs job [7], and I18n team would like to<br>
continue to work with Documentation<br>
and Infrastructure teams on actual implementation suring Stein cycle.<br>
<br>
USER SURVEY, TRANSLATING WHITEPAPERS, AND RECOGNITION ON TRANSLATORS<br>
<br>
With nice collaboration between Foundation and I18n team, I18n team<br>
started to translate<br>
OpenStack user survey [8] after initial discussion on Pike PTG and, edge<br>
computing whitepaper [9],<br>
and container whitepaer [10] into multiple languages with many language<br>
coordinators and translators.<br>
<br>
Those translation effort might be different from Active Technical<br>
Contributor (ATC) recognition<br>
which translators also got for OpenStack project translation and<br>
techical documentation translation [11].<br>
Some translators shared that they would be interested in translating<br>
technical documents but not interested in<br>
OpenStack user survey and other non-technical documents.<br>
<br>
I thought that it might be due to different governance (Foundation-led &<br>
official projects with technical committee might be different),<br>
and Active User Contributor (AUC) [12] recognition might be a good idea.<br>
Although I could not discuss in details with User Committee members<br>
during PTG,<br>
Foundation agreed that AUC recognition for such translators would be a<br>
good idea and Melvin,<br>
one of user committee agreed with the idea during a very short conversation.<br>
In my opinion, it would take some time for more discussion and agreement<br>
on detail criteria<br>
(e.g., which number of words might be good aligning with current AUC<br>
recognition criteria), User Committee, and Foundation),<br>
but let's try to move forward on this :)<br>
<br>
Also, documentation on detail steps and activities with user survey on<br>
further years and more on whitepapers<br>
would be important, so I18n team will more document how I18n team<br>
members do action with steps like [13].<br>
<br>
And some translators shared concerns what there is no I18n in OpenStack<br>
project navigator and map.<br>
It would be also related with recognition on what translators contributed.<br>
Foundation explained that it might be the intention of the purpose of<br>
each artifact<br>
(e.g., OpenStack were designed to show OpenStack components and how<br>
those components interact each other with technical perspective),<br>
and Foundation shared that Foundation would do best to aggregate<br>
scattered definitions (e.g., [14], [15], and somewhere more)<br>
for consistency, and find a nice place for Docs, i18n, Congress, etc...<br>
on the Software/Project Navigator.<br>
<br>
TRANSLATING CONTRIBUTOR GUIDE WITH FIRST CONTACT SIG<br>
<br>
The detail summary is in [16]. To summarize,<br>
 - I shared I18n process to First Contact SIG members. Participants<br>
acknowledged that<br>
   setting *translation period* would be needed but starting from<br>
initial translation process<br>
   would be a good idea since it is not translated yet<br>
 - Participants think that user groups would be interested in<br>
translating contributor guide.<br>
 - Me will setup translation sync and publication on contributor guide<br>
and Kendall Nelson would kindly<br>
   help explain the background of adding contributor guide for<br>
translator target.<br>
<br>
I18N-ING STORYBOARD [17]<br>
<br>
Although I18n team now uses Launchpad [18] for task management,<br>
I think there are mix on multiple language issues on "bugs" section,<br>
which prevents from maintance<br>
by language coordinators. After discussion on I18n mailing list [19], I<br>
thought that it would be very grat<br>
if Storyboard is internationalized so that I18n team can migrate from<br>
Launchpad to Storyboard and<br>
more global contributors access to Storyboard with their native language.<br>
<br>
One issue regarding I18n-ing Storyboard was that story description for<br>
most projects needs to be written<br>
in English, but I18n-ing Storyboard might mislead contributors to write<br>
description in non-English.<br>
Participants thought that adding a warning message on posting pages<br>
(e.g., posting a Story) would solve this issue.<br>
<br>
Participants shared current implementation technologies used in<br>
Storyboard and other dashboard projects<br>
such as Horizon and TripleO UI. Brainstorming and making use of I18n-ing<br>
libraries on Storyboard is an action item at current point.<br>
<br>
PROCESS ON OPENSTACK-HELM DOC FROM NON-ENGLISH TO ENGLISH*<br>
*<br>
I participated in a brief discussion with OpenStack-Helm team for<br>
documentation contribution from Korean to English.<br>
Current documentation and I18n process starts from English to multiple<br>
languages, but some active contributors in OpenStack-Helm team<br>
would like to contribute to Korean documentation first and translate<br>
from Korean into English.<br>
My suggestion is to keep current documentation and I18n process but add<br>
more additional steps before English rst-based documentation.<br>
For example, if OpenStack-Helm team cores agree to have<br>
*doc-ko_KR/source* folder, contributing Korean documentation is limited<br>
to the folder,<br>
Zanata helps to translate from Korean to English on the folder,<br>
translated po can make English rsts, and translated rst files are added<br>
to *doc/source* folder,<br>
there might be no affect on existing documentation & I18n process and<br>
Korean documentation contrubution and translation from Korean to English<br>
would be encouraged.<br>
<br>
OpenStack-Helm team agreed with this step, and I think this would be a<br>
good step for more Internationalization as a pilot project first but<br>
this can be extended<br>
to more projects in future.<br>
<br>
<br>
This is my summary on I18n issues discussed during Stein PTG.<br>
Thanks a lot for all members who involve and help Documentation and I18n.<br>
Although there were no discussion on setting translation plans and<br>
priorities, let's do that through [21] with Frank :)<br>
<br>
And finally, more pictures are available through [22] :)<br>
<br>
<br>
With many thanks,<br>
<br>
/Ian<br>
<br>
[1]<br>
<a href="https://blueprints.launchpad.net/openstack-i18n/+spec/project-doc-translation-support" rel="noreferrer" target="_blank">https://blueprints.launchpad.net/openstack-i18n/+spec/project-doc-translation-support</a><br>
[2] <a href="https://review.openstack.org/#/c/545377/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/545377/</a><br>
[3] <a href="https://review.openstack.org/#/c/581000/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/581000/</a><br>
[4] <a href="https://etherpad.openstack.org/p/YVR-docs-support-pdf-and-translation" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/YVR-docs-support-pdf-and-translation</a><br>
[5] <a href="https://review.openstack.org/#/c/580495/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/580495/</a><br>
[6]<br>
<a href="http://lists.openstack.org/pipermail/openstack-dev/2018-September/134609.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2018-September/134609.html</a><br>
[7]<br>
<a href="https://docs.openstack.org/infra/openstack-zuul-jobs/jobs.html#job-openstack-tox-docs" rel="noreferrer" target="_blank">https://docs.openstack.org/infra/openstack-zuul-jobs/jobs.html#job-openstack-tox-docs</a><br>
[8] <a href="https://www.openstack.org/user-survey" rel="noreferrer" target="_blank">https://www.openstack.org/user-survey</a><br>
[9]<br>
<a href="https://www.openstack.org/edge-computing/cloud-edge-computing-beyond-the-data-center" rel="noreferrer" target="_blank">https://www.openstack.org/edge-computing/cloud-edge-computing-beyond-the-data-center</a><br>
[10]<br>
<a href="https://www.openstack.org/containers/leveraging-containers-and-openstack/" rel="noreferrer" target="_blank">https://www.openstack.org/containers/leveraging-containers-and-openstack/</a><br>
[11]<br>
<a href="https://docs.openstack.org/i18n/latest/official_translator.html#atc-status-in-i18n-project" rel="noreferrer" target="_blank">https://docs.openstack.org/i18n/latest/official_translator.html#atc-status-in-i18n-project</a><br>
[12]<br>
<a href="https://governance.openstack.org/uc/reference/charter.html#active-user-contributors-auc" rel="noreferrer" target="_blank">https://governance.openstack.org/uc/reference/charter.html#active-user-contributors-auc</a><br>
[13] <a href="https://docs.openstack.org/i18n/latest/release_management.html" rel="noreferrer" target="_blank">https://docs.openstack.org/i18n/latest/release_management.html</a><br>
[14]<br>
<a href="https://git.openstack.org/cgit/openstack/openstack-manuals/tree/www/project-data/rocky.yaml" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/openstack-manuals/tree/www/project-data/rocky.yaml</a><br>
[15]<br>
<a href="https://github.com/ttx/openstack-map/blob/master/openstack_components.yaml" rel="noreferrer" target="_blank">https://github.com/ttx/openstack-map/blob/master/openstack_components.yaml</a><br>
[16] <a href="https://etherpad.openstack.org/p/FC_SIG_ptg_stein" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/FC_SIG_ptg_stein</a><br>
[17] <a href="https://etherpad.openstack.org/p/sb-stein-ptg-planning" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/sb-stein-ptg-planning</a><br>
[18] <a href="https://launchpad.net/openstack-i18n" rel="noreferrer" target="_blank">https://launchpad.net/openstack-i18n</a><br>
[19]<br>
<a href="http://lists.openstack.org/pipermail/openstack-i18n/2018-September/003307.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-i18n/2018-September/003307.html</a><br>
[20]<br>
<a href="http://lists.openstack.org/pipermail/openstack/2018-September/046937.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack/2018-September/046937.html</a><br>
[21]<br>
<a href="http://lists.openstack.org/pipermail/openstack-i18n/2018-September/003314.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-i18n/2018-September/003314.html</a><br>
[22]<br>
<a href="https://www.dropbox.com/sh/2pmvfkstudih2wf/AAAG2c6C_OXorMRFH66AvboYa/Docs%20%2B%20i18n" rel="noreferrer" target="_blank">https://www.dropbox.com/sh/2pmvfkstudih2wf/AAAG2c6C_OXorMRFH66AvboYa/Docs%20%2B%20i18n</a><br>
<br>
<br>
Petr Kovar wrote on 9/20/2018 8:37 AM:<br>
> Hi all,<br>
><br>
> Just wanted to share a summary of docs- and i18n-related meetings<br>
> and discussions we had in Denver last week during the Stein Project<br>
> Teams Gathering.<br>
><br>
> The overall schedule for all our sessions with additional comments and<br>
> meeting minutes can be found here:<br>
><br>
> <a href="https://etherpad.openstack.org/p/docs-i18n-ptg-stein" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/docs-i18n-ptg-stein</a><br>
><br>
> Our obligatory team picture (with quite a few members missing) can be<br>
> found here (courtesy of Foundation folks):<br>
><br>
> <a href="https://pmkovar.fedorapeople.org/DSC_4422.JPG" rel="noreferrer" target="_blank">https://pmkovar.fedorapeople.org/DSC_4422.JPG</a><br>
><br>
> To summarize what I found most important:<br>
><br>
> OPS DOCS<br>
><br>
> We met with the Ops community to discuss the future of Ops docs. The plan<br>
> is for the Ops group to take ownership of the operations-guide (done),<br>
> ha-guide (in progress), and the arch-design guide (to do).<br>
><br>
> These three documents are being moved from openstack-manuals to their own<br>
> repos, owned by the newly formed Operations Documentation SIG.<br>
><br>
> See also<br>
> <a href="https://etherpad.openstack.org/p/ops-meetup-ptg-denver-2018-operations-guide" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/ops-meetup-ptg-denver-2018-operations-guide</a><br>
> for more notes.<br>
><br>
> DOCS SITE & DESIGN<br>
><br>
> We discussed improving the site navigation, guide summaries (particularly<br>
> install-guide), adding a new index page for project team contrib guides, and<br>
> more. We met with the Foundation staff to discuss the possibility of getting<br>
> assistance with site design work.<br>
><br>
> We are also looking into accepting contributions from the Strategic Focus<br>
> Areas folks to make parts of the docs toolchain like openstackdocstheme more<br>
> easily reusable outside of the official OpenStack infrastructure.<br>
><br>
> We got feedback on front page template for project team docs, with Ironic<br>
> being the pilot for us.<br>
><br>
> We got input on restructuring and reworking specs site to make it easier<br>
> for users to understand that specs are not feature descriptions nor project<br>
> docs, and to make it more consistent in how the project teams publish their<br>
> specs. This will need to be further discussed with the folks owning the<br>
> specs site infra.<br>
><br>
> Support status badges showing at the top of docs.o.o pages may not work well<br>
> for projects following the cycle-with-intermediary release model, such as<br>
> Swift. We need to rethink how we configure and present the badges. <br>
><br>
> There are also some UX bugs present for the badges<br>
> (<a href="https://bugs.launchpad.net/openstack-doc-tools/+bug/1788389" rel="noreferrer" target="_blank">https://bugs.launchpad.net/openstack-doc-tools/+bug/1788389</a>).<br>
><br>
> TRANSLATIONS<br>
><br>
> We met with the infra team to discuss progress on translating project team<br>
> docs and, related to that, PDF builds.<br>
><br>
> With the Foundation staff, we discussed translating Edge and Container<br>
> whitepapers and related material.<br>
><br>
> REFERENCE, REST API DOCS AND RELEASE NOTES<br>
><br>
> With the QA team, we discussed the scope and purpose of the<br>
> /doc/source/reference documentation area in project docs. Because the<br>
> scope of /reference might be unclear and used inconsistently by project<br>
> teams, the suggestion is to continue with the original migration plan and<br>
> migrate REST API and possibly Release Notes under /doc/source, as described<br>
> in <a href="https://docs.openstack.org/doc-contrib-guide/project-guides.html" rel="noreferrer" target="_blank">https://docs.openstack.org/doc-contrib-guide/project-guides.html</a>. <br>
><br>
> CONTRIBUTOR GUIDE<br>
><br>
> The OpenStack Contributor Guide was discussed in a separate session, see<br>
> <a href="https://etherpad.openstack.org/p/FC_SIG_ptg_stein" rel="noreferrer" target="_blank">https://etherpad.openstack.org/p/FC_SIG_ptg_stein</a> for notes.<br>
><br>
> THAT'S IT?<br>
><br>
> Please add to the list if I missed anything important, particularly for<br>
> i18n.<br>
><br>
> Thank you to everybody who attended the sessions, and a special thanks goes<br>
> to all the PTG organizers!<br>
><br>
> Cheers,<br>
> pk<br>
><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br>
<br>
<br>
<br>
_______________________________________________<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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n</a><br>
</blockquote></div>