August 2017 - OpenStack-I18n - lists.openstack.org

[docs][ptl] Candidacy for Docs
by Petr Kovar 04 Aug '17

04 Aug '17

Hi all, I'd like to announce my candidacy for PTL of the docs project for Queens. I've been active in various open source documentation and translation projects since 2007 and started contributing to OpenStack docs during the Mitaka cycle, both upstream and in the RDO Project. The docs project has recently seen a significant decrease in both the number of submitted updates and contributors, but thanks to a group of dedicated people in the community, we've managed to come up with a clear plan to migrate docs over to individual projects, restructure them and reduce the scope to keep them maintainable. This is now well underway and I'd like to help the team and the community drive and continue with this work. In docs, we generally like to keep it rather short and simple, so let me summarize the main three points as follows: Support and help drive the remaining tasks in restructuring and/or moving content from the core docs suite. Help establish the docs team as content editors for individual project docs when needed or requested. Stay open and friendly to new contributors, no matter if they are prospective core members or drive-by docs contributors, with the understanding that docs are a great way to get involved in the project for both the non- and developers. Thank you, pk -- Petr Kovar Sr. Technical Writer | Customer Content Services Red Hat Czech, Brno

1 0

Translation bugs on Chinese China
by Akihiro Motoki 03 Aug '17

03 Aug '17

Hi Chinese language coordinator and translators, We received several number of bug reports on Chinese China translations, but unlike other languages they have not been triaged and fixed. 9 of 13 open bugs looks related to Chinese China. Can anyone from Chinese China handle these bugs? Check bugs on https://bugs.launchpad.net/openstack-i18n Unless we have good volunteers, we cannot handle translated bugs. Thanks, amotoki

2 1

[Bug 1586041] [NEW] Incorrect PO-Revision-Date in some translation files for aodh project
by Alfredo Moralejo 03 Aug '17

03 Aug '17

Public bug reported: Following .po files have empty revision date, "PO-Revision-Date: \n": aodh/locale/it/LC_MESSAGES/aodh.po aodh/locale/pt_BR/LC_MESSAGES/aodh.po aodh/locale/zh_CN/LC_MESSAGES/aodh-log-info.po aodh/locale/zh_CN/LC_MESSAGES/aodh.po aodh/locale/zh_TW/LC_MESSAGES/aodh.po This makes compile_catalog to fail: $ python setup.py compile_catalog running compile_catalog compiling catalog aodh/locale/ja/LC_MESSAGES/aodh.po to aodh/locale/ja/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/ru/LC_MESSAGES/aodh.po to aodh/locale/ru/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/pt/LC_MESSAGES/aodh.po to aodh/locale/pt/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/en_GB/LC_MESSAGES/aodh.po to aodh/locale/en_GB/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/ko_KR/LC_MESSAGES/aodh.po to aodh/locale/ko_KR/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/de/LC_MESSAGES/aodh.po to aodh/locale/de/LC_MESSAGES/aodh.mo Traceback (most recent call last): File "setup.py", line 29, in <module> pbr=True) File "/usr/lib64/python2.7/distutils/core.py", line 151, in setup dist.run_commands() File "/usr/lib64/python2.7/distutils/dist.py", line 953, in run_commands self.run_command(cmd) File "/usr/lib64/python2.7/distutils/dist.py", line 972, in run_command cmd_obj.run() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/frontend.py", line 178, in run self._run_domain(domain) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/frontend.py", line 218, in _run_domain catalog = read_po(infile, locale) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/pofile.py", line 217, in read_po _add_message() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/pofile.py", line 165, in _add_message catalog[msgid] = message File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 601, in __setitem__ self.mime_headers = _parse_header(message.string).items() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 420, in _set_mime_headers self.revision_date = _parse_datetime_header(value) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 46, in _parse_datetime_header tt = time.strptime(match.group('datetime'), '%Y-%m-%d %H:%M') File "/usr/lib64/python2.7/_strptime.py", line 467, in _strptime_time return _strptime(data_string, format)[0] File "/usr/lib64/python2.7/_strptime.py", line 325, in _strptime (data_string, format)) ValueError: time data u'' does not match format '%Y-%m-%d %H:%M' I've checked in https://translate.openstack.org that files are wrong there too, not only in github. ** Affects: openstack-i18n Importance: Undecided Status: New -- You received this bug notification because you are a member of OpenStack I18n Core Team, which is subscribed to openstack i18n. https://bugs.launchpad.net/bugs/1586041 Title: Incorrect PO-Revision-Date in some translation files for aodh project Status in openstack i18n: New Bug description: Following .po files have empty revision date, "PO-Revision-Date: \n": aodh/locale/it/LC_MESSAGES/aodh.po aodh/locale/pt_BR/LC_MESSAGES/aodh.po aodh/locale/zh_CN/LC_MESSAGES/aodh-log-info.po aodh/locale/zh_CN/LC_MESSAGES/aodh.po aodh/locale/zh_TW/LC_MESSAGES/aodh.po This makes compile_catalog to fail: $ python setup.py compile_catalog running compile_catalog compiling catalog aodh/locale/ja/LC_MESSAGES/aodh.po to aodh/locale/ja/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/ru/LC_MESSAGES/aodh.po to aodh/locale/ru/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/pt/LC_MESSAGES/aodh.po to aodh/locale/pt/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/en_GB/LC_MESSAGES/aodh.po to aodh/locale/en_GB/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/ko_KR/LC_MESSAGES/aodh.po to aodh/locale/ko_KR/LC_MESSAGES/aodh.mo compiling catalog aodh/locale/de/LC_MESSAGES/aodh.po to aodh/locale/de/LC_MESSAGES/aodh.mo Traceback (most recent call last): File "setup.py", line 29, in <module> pbr=True) File "/usr/lib64/python2.7/distutils/core.py", line 151, in setup dist.run_commands() File "/usr/lib64/python2.7/distutils/dist.py", line 953, in run_commands self.run_command(cmd) File "/usr/lib64/python2.7/distutils/dist.py", line 972, in run_command cmd_obj.run() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/frontend.py", line 178, in run self._run_domain(domain) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/frontend.py", line 218, in _run_domain catalog = read_po(infile, locale) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/pofile.py", line 217, in read_po _add_message() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/pofile.py", line 165, in _add_message catalog[msgid] = message File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 601, in __setitem__ self.mime_headers = _parse_header(message.string).items() File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 420, in _set_mime_headers self.revision_date = _parse_datetime_header(value) File "/home/amoralej/eng/babel/lib/python2.7/site-packages/babel/messages/catalog.py", line 46, in _parse_datetime_header tt = time.strptime(match.group('datetime'), '%Y-%m-%d %H:%M') File "/usr/lib64/python2.7/_strptime.py", line 467, in _strptime_time return _strptime(data_string, format)[0] File "/usr/lib64/python2.7/_strptime.py", line 325, in _strptime (data_string, format)) ValueError: time data u'' does not match format '%Y-%m-%d %H:%M' I've checked in https://translate.openstack.org that files are wrong there too, not only in github. To manage notifications about this bug go to: https://bugs.launchpad.net/openstack-i18n/+bug/1586041/+subscriptions

2 1

Re: [OpenStack-I18n] IMPORTANT upcoming change to technical elections
by Jeremy Stanley 02 Aug '17

02 Aug '17

I just posted an announcement to openstack-dev which is also relevant to some subscribers of this ML who may not see it there: http://lists.openstack.org/pipermail/openstack-dev/2017-July/119786.html If possible, please follow up there with any questions. -- Jeremy Stanley

1 1

Re: [OpenStack-I18n] [openstack-dev] string freeze exception for VMAX driver
by Akihiro Motoki 02 Aug '17

02 Aug '17

I am not sure who is responsible to respond to string freeze exception, but I will comment it as my hat of the i18n team. Looking at "cinder" translation status [1], the best progress is ~73% and 718 of 2932 message are remaining. In other languages the progress is lower. Adding two new messages does not matter. Removing messages has no problem. I see no blocking issue in this request. In addition, I think the i18n team focuses on dashboard translations and server projects are less focused for translations. IIRC the I18n team discussed an idea to announce the i18n team focus on translation to let server projects be free from string freeze around the beginning of the Pike cycle but I am not sure it is announced or not. Thanks, Akihiro [1] https://translate.openstack.org/iteration/view/cinder/master/documents?docI… 2017-08-03 3:14 GMT+09:00 Walsh, Helen <Helen.Walsh(a)dell.com>: > > > > > To whom it may concern, > > > > I would like to request a string freeze exception for 2 patches that are on > the merge queue for Pike. > > > > 1. VMAX driver - align VMAX QOS settings with front end (CI Passed) > > https://review.openstack.org/#/c/484885/7/cinder/volume/drivers/dell_emc/vm… > line 800 (removal of exception message) > > > > Although it’s primary aim is to align QoS with front end setting it > indirectly fixes a lazy loading error we were seeing around QoS which > occasionally > > Broke CI on previous patches. > > > > > > 2. VMAX driver - seamless upgrade from SMI-S to REST (CI Pending) > > https://review.openstack.org/#/c/482138/19/cinder/volume/drivers/dell_emc/v… > line 1400 ,1455 (message changes) > > > > This is vital for as reuse of volumes from Ocata to Pike. In Ocata we used > SMIS to interface with the VMAX, in Pike we are using REST. A few changes > needed to be made to make this transition as seamless as possible. > > > > Thank you, > > Helen > > > > > > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >

1 0

Re: [OpenStack-I18n] [OpenStack-docs] Summary of how I18n affects with doc-migration
by Doug Hellmann 02 Aug '17

02 Aug '17

[resending to the lists] > On Aug 1, 2017, at 10:55 AM, Doug Hellmann <doug(a)doughellmann.com> wrote: > > Excerpts from Andreas Jaeger's message of 2017-08-01 08:57:09 +0200: >> 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). > > Could we make it work that way? I understand why we need a separate > review step for the translations, but not why we need a separate > copy of the docs published outside of the context of a job in order > to perform that review. (This is probably just me not understanding > how a tool works.) > >> >>>> 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 > > It seems like we want a list of languages for which there are > translations for a given set of docs. We could use that to populate > templates in a few different ways (link from the English version > to the other languages, link from a $language landing page to all > of the guides in that language, etc.). > > I can advise someone on how to add those features, if we have a > volunteer. > > Doug

3 4

[StringFreeze] Soft period was over - Plz contribute translation for the release!
by Ian Y. Choi 02 Aug '17

02 Aug '17

Dear language coordinators & translators! Only a few weeks left before official Pike release [1] and I would like to inform you that the last week was the Soft StringFreeze period. Language teams need to focus on Horizon and Horizon-related projects before all translated strings will be packaged for upcoming release. According to the dashboard on https://translate.openstack.org, our targeted priorities look as follows: - Dashboard - Horizon (High) - Dashboard Authorization Page (High) - Magnum UI (Medium) - Trove Dashboard (Medium) - Sahara Dashboard (Medium) - neutron-lbaas-dashboard (Medium) - Murano Dashboard (Low) - Designate Dashboard (Low) - TripleO UI (Low) All of those and more additional target projects grouped in [2] in *master* branch and current & next PTL will check feature freeze status on projects listed above. He will create a stable version: *stable-pike* in Zanata for the target projects after the project have stable/pike branch. Although the stable version has not been created yet, but it is highly encouraged to translate those projects from now, since StringFreeze periods are relatively short (about 2 weeks of RC1, then HardStringFreeze). For more details on how I18n team is doing with releases (especially Horizon & plugin projects), please see [3]. If you have questions, feel free to ask through openstack-i18n at lists.openstack.org mailing list or ask I18n members on Freenode #openstack-i18n channel. Thank you all for your contribution! [1] https://releases.openstack.org/pike/schedule.html [2] https://translate.openstack.org/version-group/view/pike-dashboard-translati… [3] https://docs.openstack.org/i18n/latest/release_management.html With many thanks, /Ian

4 3

French member with no role
by Akihiro Motoki 02 Aug '17

02 Aug '17

Hi French team coordinators, I see one member in French language team has no role. What does this mean? Is he considered as a translator? This is just a question and to clarify the situation. I see a warning every time I run a script to sync Zanata users list into the i18n repo. Thanks, Akihiro

2 3

[Elections] Candidacy for I18n PTL (Queens)
by Frank Kloeker 01 Aug '17

01 Aug '17

Good morning! Today I would like to announce my candidacy as I18n PTL in Queens cycle. I've been in the OpenStack Community since 2015, active as a translator in the German team. I participated in my first OpenStack Summit in Tokyo and met the I18n team for the first time at the Design Summit. It was an exciting moment to meet people from all over the world working on the same thing. It is not just translations, but working with different cultures, views and ... time zones. These are the magical dimensions and challenges. After Tokyo we had virtual midcycle sprint to develop the translation check site, one of the tools to help translators in their work. I met more people during Barcelona Summit and sank deeper and deeper into the work of OpenStack and I18n. In Boston we had our own session to show the work of the I18n team. We prepared a workshop also which was not so successful, but the preparation was great and we can repeat it at any time. At this point I would like to thank Ianychoi for his excellent work in the past as PTL. He is tireless, full of energy, and brought I18n far forward. He was for me in the last weeks a kind of mentor to learn all the things related to I18n and PTL. Nevertheless, I still need support from the entire team to successfully manage this task. What goals have I set for myself for Queens: 1. Completion of the translation check site. I have been involved in this project since 2015 and now it has to be finished :-) 2. Automate all the things. We have some manual work in I18n and our tools that are to automate to make the work easier. 3. Aquire more people to the team. We have great teams that do a lot. But we also get more work through translate new OpenStack projects or the User Survey. I hope I have given a good overview. Contact me directly if you have any questions or requests. On good cooperation in a new cycle of OpenStack! kind regards Frank Email: eumel(a)arcor.de IRC: eumel8 Twitter: eumel_8 OpenStack Profile: https://www.openstack.org/community/members/profile/45058/frank-kloeker

2 1

Re: [OpenStack-I18n] [OpenStack-docs] Summary of how I18n affects with doc-migration
by Andreas Jaeger 01 Aug '17

01 Aug '17

On 2017-07-31 22:46, Doug Hellmann wrote: > [...] > This is good to know. I am going to need someone who knows how the > translation jobs work to help set those up. I can assist, but I do not > know how they work so I cannot lead that effort. Doug, I'm happy to have a discussion with you - and anybody else - on these. We can do a special IRC session or some kind of videochat. Who else wants to join? Once I know participants, let's set up something... Andreas -- Andreas Jaeger aj(a){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

2 1

Re: [OpenStack-I18n] [OpenStack-docs] Summary of how I18n affects with doc-migration
by Andreas Jaeger 31 Jul '17

31 Jul '17

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(a){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

1 0

Summary of how I18n affects with doc-migration
by Ian Y. Choi 31 Jul '17

31 Jul '17

Hello translators, The OpenStack manuals project migration [1] has been going well, and I would like to share what I have found which things influence on I18n activities from the perspective of translators, since some translators asked me about missing some openstack-manuals documents in Zanata. 1. Removal of documents in openstack-manuals project in Zanata In [2], the following documents are not currently visible : admin-guide, arch-design, networking-guide, ops-guide, user-guide . For several release cycles, there have been less amount contribution on admin-guide (migrating to each project tree) and arch-design (deprecated). For networking-guide, translating in stable-ocata will be preserved, but master version was removed and the content will be migrated into neutron repository. User-guide will be migrated and divided between the horizon repository and python-openstackclient repository. If the strings for the migrated projects (admin-guide, networking-guide, and user-guide) would be the same as the removed strings in openstack-manuals, I18n team expects that translation memory merge functionality in Zanata would be able to fill out translations for the migrated projects. Note that the translation support work of migrated documents will be started after the migration completes and I18n team need volunteers for the work. 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. 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. 3. Archiving translated documents is also needed Liberty translated documents (e.g., [6]) and translated documents which were migrated (e.g., [7], [8]) are still accessible through docs.o.o. In my opinion, those translated documents are also the target of archiving documents [9]. For translated documents, I think just publishing htmls as read-only (e.g., github pages?) would be fine, and the work needs volunteers. With many thanks, /Ian [1] http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migra… [2] https://translate.openstack.org/iteration/view/openstack-manuals/master/doc… [3] https://translate.openstack.org/iteration/view/openstack-manuals/stable-oca… [4] https://docs.openstack.org/pike/index.html [5] http://git.openstack.org/cgit/openstack/openstack-manuals/tree/www/project-… [6] https://docs.openstack.org/liberty/ko_KR/install-guide-ubuntu/ [7] https://docs.openstack.org/ja/user-guide/ [8] https://docs.openstack.org/ja/ops-guide/ [9] http://specs.openstack.org/openstack/docs-specs/specs/pike/archiving.html [10] https://etherpad.openstack.org/p/denver-doc-PTG

2 1