- OpenStack-I18n - lists.openstack.org

Horizon translation check site
by KATO Tomoyuki 13 May '15

13 May '15

Hi team, Motoki-san, We did not have Horizon translation check site for Kilo release cycle from my understanding. We previously discussed this topic in this ML. Do we have a conclusion? Need more discussion? Thanks, KATO Tomoyuki

3 2

Separating User Guides
by Andreas Jaeger 13 May '15

13 May '15

FYI, we're separating the User Guides again into two directories. Once this is done, we will have again user-guide and user-guide-admin resources. I will copy over all content from the current user-guides to these and then remove the user-guides. Patch series: https://review.openstack.org/#/q/status:open+project:openstack/openstack-ma… Docs discussion: http://lists.openstack.org/pipermail/openstack-docs/2015-May/006581.html Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

1 1

I18n team working sessions in Vancouver summit
by Ying Chun Guo 11 May '15

11 May '15

Hello, We have 2 working sessions in Vancouver summit. They are: * Translation team working session [1] * Building translation platform [2] The first session is for discussions related with our translations. The second session is for discussions related with moving to Zanata. I18n team members who would go to Vancouver summit are strongly recommended to attend these sessions. You can edit Etherpad pages to add the topics you want to discuss. The links to Etherpad pages are: https://etherpad.openstack.org/p/Vancouver-I18n-WG-session https://etherpad.openstack.org/p/Vancouver-I18n-Translation-platform-session Hope to see you in Vancouver. Thank you. Best regards Ying Chun Guo (Daisy) [1] https://openstacksummitmay2015vancouver.sched.org/event/f008932bfc685abe742… [2] https://openstacksummitmay2015vancouver.sched.org/event/83ceed4873820c889e7…

1 0

website translation
by KATO Tomoyuki 10 May '15

10 May '15

Hi team, I want to translate website "www.openstack.org" as whole as possible. However, I don't understand how website are maintained. So, I will investigate. Are you interested in website translation? Does anyone help me? My Requirement(priority): 1. automatically periodic (eg:every 1H) update translation 2. use Transifex(/Zanata) for translation tool -> need to generate pot files It is easy to translate for translator. Thanks, KATO Tomoyuki

2 2

IRC meeting tomorrow
by Ying Chun Guo 06 May '15

06 May '15

Hello team I would use tomorrow's IRC meeting to prepare for the Vancouver summit meetings. People who would go to Vancouver are strongly desired to show up. Following topics would be covered: * Agenda of I18n team meetings in Vancouver summit * Open discussions Hope to see you in IRC channel of #openstack-meeting at 0800 UTC. Best regards Ying Chun Guo (Daisy)

1 0

Persian translate
by کاربرخوب لینوکس 29 Apr '15

29 Apr '15

Salam Hello I am Contributing some project to translate to farsi such as debian , ... I like to start and Contribute open stack translation for persian users. Thanks

2 1

Decreasing size of PO files
by Andreas Jaeger 23 Apr '15

23 Apr '15

Our PO files contain information about location (filename and line numbers) as well as untranslated strings. Dolph suggested to me recently to import into projects only the *translated* strings and I did some investigation and implementation. I don't expect this to have any negative impact but wanted to inform you and ask for feedback. We will continue to push the full location information to transifex and leave it in the POT files that are stored in each repository. Thus if you download a file from transifex, you have all location information. During the import from transifex into the OpenStack git repositories, our scripts remove the location information as well as any untranslated strings thus reducing the files to import significantly. This also reduces the change of an import significantly since a line number change will not cause many location information to be updated. The gettext tools we use can cope fine with this smaller PO file since it contains everything that is needed - just nothing more ;) Also, it's easy to rebuild the full PO file from the date in the repository using the msgmerge command: msgmerge POT-FILE PO-FILE -o FULL-PO-FILE As a first step, I have made this change for documentation projects like openstack-manuals only: https://review.openstack.org/176313 If this works as expected, I plan to do it for other projects as well. Please review and tell me if you have any further ideas or if I overlooked something, Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

3 5

Final call for Horizon translations for Kilo
by Akihiro Motoki 23 Apr '15

23 Apr '15

Hi all! Horizon RC1 was just shipped yesterday. This means we are now in the deep string freeze and no string changes are expected. I hope you all keep your translations up-to-date in time. I would like to share some important topics with you. TRANSIFEX RESOURCE: Liberty development cycle is now open. You will see resource names with Liberty. For Kilo translation, please translate the resources whose names have "Kilo". IMPORTANT DATE: The final translation import is planed on Apr 23. I talked with David, Horizon PTL and the above date works for Horizon team. I don't set the exact time of the deadline, but I will do the final import in the day of Apr 23 (UTC timezone). Please don't bother me on the deadline:-) IMPORT CRITERIA: I would like to set the criteria to import to 90% completion rate (as we discussed before), OR language coordinator request. Horizon now covers various new services and in some case translation rate does not work, so I would like to honor language coordinator decision. Daisy and the team, does it make sense? If not, please start a new thread to discuss this topic. Thanks, Akihiro

3 8

Draft Documents published, next steps with draft publishing and RST translation
by Andreas Jaeger 19 Apr '15

19 Apr '15

As part of the draft publishing spec [1], we now publish all draft documents to docs.openstack.org/drafts. To read or review, go to http://docs.openstack.org/draft/draft-index.html Translation team, as part of this, the draft-i18n-manuals.html page has been removed, the content is in draft-index.html now. Next steps are moving draft language guides also to /draft/ For this, let's merge [2], release openstack-doc-tools 0.25 and then I'll adjust and remove the script changes from [3] and [4]. The script changes in [3] and [4] are part of the openstack-doc-tools patch [2] and give you the chance to review the patches and scripts independently. Andreas [1] http://specs.openstack.org/openstack/docs-specs/specs/kilo/draft-publishing… [2] https://review.openstack.org/175190 [3] https://review.openstack.org/#/c/162424/ [4] https://review.openstack.org/#/c/175157/ -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

1 0

Status of the RST Documentation Toolchain
by Tom Fifield 16 Apr '15

16 Apr '15

Hi, Andreas, Daisy, Motoki-san and myself have just had an impromptu hour-long discussion regarding the Status of the RST Documentation Toolchain, particularly its translation components. This meeting was spurred on by the email to the i18n mailing list announcing the pending removal of docbook user guides, and all present acknowledged the meeting would have been great if it had happened sooner :) This is the brief summary! 1. Everyone involved wants to make translators happy, and hopes that the process of moving to RST can deliver an improved toolchain 2. There has been inadequate communication between the documentation team and the i18n team regarding requirements and timelines during this process and we will strive to improve this 3. Previous statement that RST-based docs would not be published without agreement on the translation toolchain was acknowledged 4. Based on the user guide example, about 50% of existing translated strings (1943 vs 943) need to be re-translated with the current conversion process 5. Noone on the i18n team had yet the opportunity to assess the strings produced by the RST in a fuller guide and problems weren't picked up with initial version of guides in the playground folder 6. Daisy in particular hasn't been able to log in to transifex today to check the new user guide. We are currently using the standard Sphinx translation tools, though, there was some definite concern over the quality of the strings produced by the RST, including: 1. Strings that should have been trivially updated during conversion from docbook without human interaction needed (eg **string**\n) 2. Strings that are entirely markup (eg :ref:`Boot_instance_from_image_and_attach_non-bootable_volume`) 3. Strings that contain significant amounts of markup 4. Strings that contain markup characters that are unusual for translations, eg backticks, asterisks 5. Strings that contain markup where placeholders were previously used 6. ... this list is incomplete and comes only from what amotoki and fifieldt saw during the meeting - the broader i18n community has not yet been asked for feedback outside of Andreas' recent email 7. There is an open issue about how to fix problems like the above. 1. Andreas stated that not maintaining our own custom scripts is a good aim, and some of the issues above could be handled with a one time fix at conversion time 2. Daisy & Tom stated that they preferred such issues to be fixed in the toolchain 3. Just looking at the "** STRING **" issue, it's 70 strings but a quick proof of concept didn't result in fixing the issue - we haven't worked out why yet. 4. The current toolchain is difficult to modify, since it relies on an upstream component that is used by multiple projects, meaning post processing and pre-processing are the only real approach we have 5. It could be complicated to use post-processing and pre-processing to implement fixes for issues beyond the trivially updated string example in the current toolchain 8. There is an open question about whether it is possible to deliver an improved i18n experience with the current toolchain 9. There is not yet agreement that the current documentation toolchain is meeting the needs of the i18n team Based on the meeting, and especially the fact that due to inadequate communication the i18n team (inc Daisy) has not yet had the opportunity to assess the RST documentation toolchain fully, I would propose that the removal of existing guides and publication of RST guides be delayed until that's happened. We suggest that Daisy does an initial assessment and arrange a meeting to discuss next steps as soon as possible.There are many things we can fix with the the toolchain any time after publication, however it is important that we assess what needs to be done and ensure that we can actually feasibly deliver an improved experience for our translations, as well as our doc team. Regards, Tom

6 11