- OpenStack-I18n - lists.openstack.org

What's Up, Doc? 17 June 2016
by Lana Brindley 17 Jun '16

17 Jun '16

Hi everyone, This week I've very pleased to announce that we have our first project-specific Install Guide published! Petr Kovar got Heat over the line in first place, and it's looking great: http://docs.openstack.org/project-install-guide/orchestration/draft/index.h… Well done Petr, and of course all the wonderful docs people who helped us get to this point. We're also expecting to see Trove published very soon. I've been using the lessons learned from these early projects to flesh out our instructions a little more, so it should be even easier for projects to get their Install Guides up and running. We still need to create the central index, but it's all starting to come together now. I'm also excited to announce that, for the very first time, we have a specific Ops Cross-Project Liaison. Please welcome Robert Starmer to the CPL family :) == Progress towards Newton == 110 days to go! Bugs closed so far: 185 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. Also, just a note that the CFP for Barcelona is open now, until 13 July. If you want to brainstorm some documentation-related ideas, please get in touch! == Speciality Team Reports == '''HA Guide: Bogdan Dobrelya''' No report this week. '''Install Guide: Lana Brindley''' Orchestration is done! Well done, Petr :) Working on updating instructions in the Contributor Guide. Instructions: http://docs.openstack.org/contributor-guide/project-install-guide.html Next meeting: Tue 21 June 0600 UTC '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' Began a consistency and IA plan, and held the US meeting. Emailing one new interested contributor. '''Ops Guide: Darren Chan''' Some architecture content moved from the Ops Guide to the draft Arch Guide. Patches will be submitted to remove old content from the Ops Guide. Team is currently reviewing enterprise ops documentation to incorporate into the Ops Guide. '''API Guide: Anne Gentle''' Check out all the open reviews for api-ref: https://review.openstack.org/#/q/status:open+file:api-ref Nice. Went to weekly team meeting for swift, landed build patch for swift's api-ref, responding to reviews. Noodling with Karen Bradshaw about API navigation, https://review.openstack.org/#/c/329508/ (though I can't take any credit for the work!) '''Config/CLI Ref: Tomoyuki Kato''' Closed many bugs continuously. Started working on the common configurations for shared services and libraries. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' No report this week. == Training Guides/Labs Core Team Changes == We've adjusted the training guides and labs core teams so that speciality team leads are core in their own repos, and the docs core team is an 'included group' in both repos. This is intended to stop the core teams for these groups drifting out of date too quickly. Note that it is expected that docs cores will not be the primary reviewers/mergers for training repos, but are there as backup in case extra eyes are needed. That responsibility will continue to lie with the training teams themselves, as they know the codebase the best. You can see the updated core team lists here: Training Guides: https://review.openstack.org/#/admin/groups/uuid-3490bf37012cb344104cb315f3… Training Labs: https://review.openstack.org/#/admin/groups/1118,members == Site Stats == During May the top viewed book was the Mitaka Ubuntu Install Guide, followed closely by the Mitaka RDO Install Guide. Rolling into third place was the Admin Guide. Also, apologies for an error I made in this section last week. The correct number for the total number of views in May was 2,365,626. == Doc team meeting == Next meetings: The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-06-15 Next meetings: US: Wednesday 22 June, 19:00 UTC APAC: Wednesday 29 June, 00:30 UTC Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_mee… -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#17_June_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

1 0

FYI: Translation Sync jobs in Healthboard
by Andreas Jaeger 15 Jun '16

15 Jun '16

Thanks to Matthew's work on the OpenStack Health board, there's now an easy way to check whether any of the translation infra jobs fail: Post jobs - syncing to Zanata: http://status.openstack.org/openstack-health/#/g/build_queue/post?groupKey=… Periodic jobs: Syncing into repos: http://status.openstack.org/openstack-health/#/g/build_queue/periodic?group… Hope that helps reviewing what's happening for those that are curious like me, 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 2

Re: [OpenStack-I18n] FYI: Translation Sync jobs in Healthboard
by Kato, Tomoyuki 15 Jun '16

15 Jun '16

Thanks, Matthew, Andreas. It is exactly what I need. KATO Tomoyuki > Thanks to Matthew's work on the OpenStack Health board, there's now an easy > way to check whether any of the translation infra jobs fail: > > Post jobs - syncing to Zanata: > > http://status.openstack.org/openstack-health/#/g/build_queue/post?grou > pKey=build_queue&searchJob=translation > > Periodic jobs: Syncing into repos: > http://status.openstack.org/openstack-health/#/g/build_queue/periodic? > groupKey=build_queue&searchJob=translation > > Hope that helps reviewing what's happening for those that are curious like > me, > > Andreas

2 2

[Bug 1580585] [NEW] [install-guide] Korean: "one or greater" should be translated into Korean
by Ian Y. Choi 14 Jun '16

14 Jun '16

Public bug reported: In Korean install-guide documentation, one sentence looks strange : "명령에대해 one or greater 값으로 반환되면, compute 노드에서 하드웨어 가속을 지원하는 것이니 추가적인 구성이 필요하지 않습니다." ( http://docs.openstack.org/mitaka/ko_KR/install-guide-ubuntu/nova-compute-in… ) "one or greater" should be translated. ** Affects: openstack-i18n Importance: Undecided Status: Confirmed ** Tags: install-guide korean ** Tags added: korean ** Changed in: openstack-i18n Status: New => Confirmed ** Tags added: install-guide -- 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/1580585 Title: [install-guide] Korean: "one or greater" should be translated into Korean Status in openstack i18n: Confirmed Bug description: In Korean install-guide documentation, one sentence looks strange : "명령에대해 one or greater 값으로 반환되면, compute 노드에서 하드웨어 가속을 지원하는 것이니 추가적인 구성이 필요하지 않습니다." ( http://docs.openstack.org/mitaka/ko_KR/install-guide-ubuntu/nova-compute-in… ) "one or greater" should be translated. To manage notifications about this bug go to: https://bugs.launchpad.net/openstack-i18n/+bug/1580585/+subscriptions

1 1

[Bug 1542487] Re: extraneous spaces in some files in Glance translations
by Ian Y. Choi 10 Jun '16

10 Jun '16

Italian po files were also fixed through : https://review.openstack.org/#/c/325542/2/glance/locale/it/LC_MESSAGES/glan… : https://review.openstack.org/#/c/325543/1/glance/locale/it/LC_MESSAGES/glan… ** Changed in: openstack-i18n Status: Fix Committed => Fix Released -- 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/1542487 Title: extraneous spaces in some files in Glance translations Status in openstack i18n: Fix Released Bug description: Left comments in the files on this review: https://review.openstack.org/#/c/276056/2 The two files affected are: * glance/locale/it/LC_MESSAGES/glance.po * glance/locale/ko_KR/LC_MESSAGES/glance.po To manage notifications about this bug go to: https://bugs.launchpad.net/openstack-i18n/+bug/1542487/+subscriptions

2 1

What's Up, Doc? 10 June 2016
by Lana Brindley 10 Jun '16

10 Jun '16

Hi everyone, My week has been spent on the Install Guide, and a big thanks to Andreas for getting the Infra patch up and documenting the new process. The Install Guide team meeting was well attended this week, and I've been following up on the actions from that. I also contacted the cross project liaisons with the information they need to get their content moved, and I'm looking forward to seeing some of these start work next week. In other news, Joseph has been busy reviewing the User Guides, and could use a little help working on the information architecture, and getting a few new projects documented. User Guide meetings are held in US and APAC timezones and volunteers are essential to get this effort complete for Newton. Get all the info here: https://wiki.openstack.org/wiki/User_Guides == Progress towards Newton == 117 days to go! Bugs closed so far: 163 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Bogdan Dobrelya''' No report this week. '''Install Guide: Lana Brindley''' Infra patch: https://review.openstack.org/#/c/326039/ Instructions: http://docs.openstack.org/contributor-guide/project-install-guide.html Next meeting: Tue 21 June 0600 UTC '''Networking Guide: Edgar Magana''' No meeting this week. Working on a better ToC for the guide that may impact of the of scenarios. Moving more networking content from other guides into the Networking one in order to keep everything in one central point and better updated. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' Outstanding Tasks - Contacting more project teams for inclusion status, IA plans for the new guide. Some team discussion on fixing old links - contact me if anyone is interested in contributing more content to the User Guides team. '''Ops Guide: Shilla Saebi''' Ops tasks are documented here: https://etherpad.openstack.org/p/ops-arch-tasks OpenStack ops guide reorg in progress & documented here: https://etherpad.openstack.org/p/ops-guide-reorg Working on posting enterprise docs for cleanup. Looking for volunteers in ops/arch docs group to attend ops specific meetings to find additional info and help. '''API Guide: Anne Gentle''' Call for help for unified all-OpenStack API navigation design: http://lists.openstack.org/pipermail/openstack-docs/2016-June/008730.html Discussing project-level organization in https://review.openstack.org/312259 Discussing source organization in https://review.openstack.org/314819 Redirects and deletions in api-site are welcomed! For example, see https://review.openstack.org/327399 Updated README for api-site: https://review.openstack.org/327395 '''Config/CLI Ref: Tomoyuki Kato''' Closed a few bugs continuously. Cleaned up many bugs about tool-generated configuration options that are already released for Mitaka. **We need folks for vendor plug-in docs from each vendor.** '''Training labs: Pranav Salunke, Roger Luethi''' Working on the training-labs landing page to make it look much better. Reintroducing the tooling to build zip files. Working on PXE support for baremetal provisioning. Working on Python port of training-labs. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' No report this week. == Site Stats == During May, the docs.openstack.org site had 620 sessions, with just under 20% by new users. The average time of all sessions for the month was about 5 and a half minutes, looking at an average of 3 and a half pages. == Doc team meeting == Next meetings: The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-06-08 Next meetings: APAC: Wednesday 15 June, 00:30 UTC US: Wednesday 22 June, 19:00 UTC Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_mee… -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#10_June_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

2 1

[Bug 1536226] Re: Not all .po files compiled
by OpenStack Infra 07 Jun '16

07 Jun '16

Reviewed: https://review.openstack.org/319260 Committed: https://git.openstack.org/cgit/openstack/keystone/commit/?id=16d0cdba47a0ad… Submitter: Jenkins Branch: master commit 16d0cdba47a0ad976f1500cd91c420860c3ad149 Author: Sven Anderson <sven(a)redhat.com> Date: Fri May 20 15:54:27 2016 +0200 Let setup.py compile_catalog process all language files Two years ago the translation files have been split into several files, separating the log messages of different log levels from each other, like X.pot, X-log-warning.pot, X-log-info.pot, and so on. However, the setup.py command `compile_catalogs`, that comes from the babel package and compiles the corresponding .po files into .mo files, only supported one file per python package. This means that during packaging `compile_catalogs` never compiled the X-log-*.po files, so the corresponding translations were always missing. Since babel 2.3 the domain can be set to a space separated list of domains. This change adds the the additional log level files to the domain list. The obsolete check that .po and .pot files are valid is removed from tox.ini. Change-Id: I1f0bfb181e2b84ac6dd0ce61881cd2cc4400bdcb Closes-Bug: #1536226 ** Changed in: keystone Status: New => Fix Released -- 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/1536226 Title: Not all .po files compiled Status in Cinder: New Status in Glance: In Progress Status in heat: New Status in OpenStack Identity (keystone): Fix Released Status in neutron: New Status in OpenStack Compute (nova): Fix Released Status in openstack i18n: New Bug description: python setup.py compile_catalog only compiles one <domain>.po file per language to a <domain>.mo file. By default <domain> is the project name, that is nova.po. This means all other nova-log-*.po files are never compiled. The only way to get setup.py compile the other files is calling it several times with different domains set, like for instance `python setup.py --domain nova-log-info` and so on. Since this is not usual, it can be assumed that the usual packages don't contain all the .mo files. To manage notifications about this bug go to: https://bugs.launchpad.net/cinder/+bug/1536226/+subscriptions

1 0

Re: [OpenStack-I18n] [openstack-dev] [zaqar][zaqar-ui][i18n] Translation enabled
by Akihiro Motoki 07 Jun '16

07 Jun '16

Forwarded to openstack-i18n list. > Shu The dev list is not an appropriate place to announce this kind of information. Translators are not developers, so in generally translators do not subscribe the dev ML. Akihiro 2016-06-07 10:19 GMT+09:00 Shuu Mutou <shu-mutou(a)rf.jp.nec.com>: > Hi everyone, > > Now, we can translate Zaqar-UI on Zanata, please translate Zaqar-UI into your native language!! > Translation is another good review for Zaqar-UI, so I hope your help. > > See also https://wiki.openstack.org/wiki/I18nTeam > > > Best regards, > > Shu Muto > > > __________________________________________________________________________ > 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

What's Up, Doc? 3 June 2016
by Lana Brindley 03 Jun '16

03 Jun '16

Hi everyone, I'm very pleased to be able to announce the results of our Install Guide naming poll this week. We ended up with 31 responses, and a very clear winner in "OpenStack Installation Tutorial". Thank you to everyone who voted! Also, just a note that I'm still very much in need of representatives from the various project teams to pitch in and help us get things running. Please make sure your project is represented by coming along to meetings, or at least contacting us through the mailing list. This week I've also spent some time with the Upstream training team, identifying gaps in the current material, and preparing for Barcelona. == Progress towards Newton == 124 days to go! Bugs closed so far: 134 Newton deliverables https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Bogdan Dobrelya''' No report this week. '''Install Guide: Lana Brindley''' Poll concluded, winner is "OpenStack Installation Tutorial". Connected with CPLs this week to encourage more participation. Next meeting: Tue 7 June 0600 UTC. '''Networking Guide: Edgar Magana''' Moved DHCP HA chapter to Networking Guide for better maintenance and updates. Planning to move more sections and focus on DVR HA. Suffering of very low attendance for the IRC meeting. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' Some contact with the Magnum team. Held meetings, brought up the link changes, which is something I most need some assistance with. IA plan still forthcoming. '''Ops Guide: Shilla Saebi''' No report this week. '''API Guide: Anne Gentle''' New layout for API reference docs from additions to openstackdocs theme. Also already added four-color scheme for GET/PUT/POST/DELETE Thanks Graham Hayes! Work in progress here: https://api.os.gra.ham.ie/compute/ Reviews: https://review.openstack.org/#/q/project:openstack/openstackdocstheme+statu… and https://review.openstack.org/#/q/project:openstack/os-api-ref+status:open Discussion on SDKs and FirstApp audience happening on user-committee list: http://lists.openstack.org/pipermail/user-committee/2016-May/000889.html '''Config/CLI Ref: Tomoyuki Kato''' Closed some bugs with Mitaka backport. Fixed the incorrect RST markup at the new options section, with generation tool update. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' Upstream training updates, Barcelona schedule. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' The first prototype of content was presented and source information gaps were identified. A first draft will be complete by June 9. == Site Stats == In the Install Guide naming poll, "OpenStack Installation Tutorial" finished with 29% of the vote, well ahead of "OpenStack Evaluation Setup Guide" at 19%, and "Basic Install Guide" at 16%. And, because charts are fun, here are the final results: https://docs.google.com/spreadsheets/d/1VlNFebI_KFobs-XIT5oRhULRymwrqON8SV9… I personally thought "OpenStack from Scratch" was the most creative title. And the potentially confusing "Manual Install Guide" ("Guided Install Manual"?) had a small following at just under 10% of the vote. Thanks for all the great suggestions :) == Doc team meeting == Next meetings: The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-06-01 Next meetings: US: Wednesday 8 June, 19:00 UTC APAC: Wednesday 15 June, 00:30 UTC Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_mee… -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#3_June_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

1 0

Documentation list for translation
by Kato, Tomoyuki 02 Jun '16

02 Jun '16

Hi team, As Akihiro requested at today's meeting, I have written the documentation list for translation. https://etherpad.openstack.org/p/i18n-docs If it contains an error, please correct it. Regards, KATO Tomoyuki

2 1