- OpenStack-I18n - lists.openstack.org

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 03 Jun '16

03 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

[Bug 1536226] Re: Not all .po files compiled
by Sven Anderson 02 Jun '16

02 Jun '16

** Also affects: cinder Importance: Undecided Status: New ** Also affects: heat Importance: Undecided Status: New ** Also affects: neutron Importance: Undecided Status: New ** Changed in: cinder Assignee: (unassigned) => Sven Anderson (ansiwen) ** Changed in: keystone Assignee: (unassigned) => Sven Anderson (ansiwen) ** Changed in: heat Assignee: (unassigned) => Sven Anderson (ansiwen) ** Changed in: neutron Assignee: (unassigned) => Sven Anderson (ansiwen) -- 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): New 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

[Bug 1536226] Re: Not all .po files compiled
by Andreas Jaeger 02 Jun '16

02 Jun '16

keystone change: https://review.openstack.org/#/c/319260/ ** Also affects: keystone 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/1536226 Title: Not all .po files compiled Status in Glance: In Progress Status in OpenStack Identity (keystone): 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/glance/+bug/1536226/+subscriptions

1 0

meeting in 2 hours at 06:00 UTC
by Kato, Tomoyuki 02 Jun '16

02 Jun '16

Hi team, I18n meeting will start in 2 hours in #openstack-meeting. See you there, KATO Tomoyuki

1 0

[Bug 1536226] Re: Not all .po files compiled
by Nikhil Komawar 29 May '16

29 May '16

** Also affects: glance Importance: Undecided Status: New ** Changed in: glance Status: New => In Progress ** Changed in: glance Importance: Undecided => High ** Changed in: glance Assignee: (unassigned) => Sven Anderson (ansiwen) -- 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 Glance: In Progress 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/glance/+bug/1536226/+subscriptions

1 0

What's Up, Doc? 27 May 2016
by Lana Brindley 27 May '16

27 May '16

Hi everyone, This week I've been focused on getting the Install Guide project back up and running, with the team meeting being rebooted, our specs finally merged, and organising the list of tasks to be getting on with. Also, don't forget to vote in our naming poll: http://goo.gl/forms/Eqf9WOGqsXjkRbdc2 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. In other news, the Ops and Arch Guide re-architecture is proceeding apace. Specs were merged this week, and the new Arch Guide ToC is looking great! Check it out here: http://specs.openstack.org/openstack/docs-specs/specs/newton/arch-guide-res… We are also still looking for feedback on the current Ops guide. Add your notes here: https://etherpad.openstack.org/p/ops-guide-reorg == Progress towards Newton == 131 days to go! Bugs closed so far: 107 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''' Specs are now merged, an blueprints created. Tasks listed here: https://wiki.openstack.org/wiki/Documentation/InstallGuideWorkItems Please go ahead and pick up work items. Need project representation in meetings. Next meeting: Tue 7 June 0600 UTC '''Networking Guide: Edgar Magana''' We did not have meeting this week. Nothing to report. Next IRC meeting: Thursday June 2nd at 1600 UTC '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' Action items to follow up - email meeting minutes to the mailing list to update the community. Currently, the team has two contributors. Please let me know if you're interested in working on the User Guide Team. '''Ops Guide: Shilla Saebi''' Shilla & Darren working on collecting enterprise docs to push upstream 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 Spec was merged: https://review.openstack.org/#/c/311998/ '''API Guide: Anne Gentle''' No report this week. '''Config/CLI Ref: Tomoyuki Kato''' A few configuration docs patches for some vendor plug-ins has been merged, with mitaka backport. Heat CLI is marked as deprecated. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' Updates for Upstream training material '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' No report this week. == Site Stats == This month, two thirds of our site visitors have been using their Mac to read the docs. Just under 30% used Windows, and Linux rounded out the remainder at 4%. So far in the Install Guide naming poll, "OpenStack Installation Tutorial" has a commanding lead at 30%, with "Basic Install Guide" and "OpenStack Evaluation Setup Guide" (try saying that ten times fast!) tying for second place with 17% of the vote each. I'll keep the poll open for another week or so, and announce our winning name in next week's newsletter. == 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-05-25 Next meetings: APAC: Wednesday 1 June, 00:30 UTC US: Wednesday 8 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#27_May_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

1 0

Re: [OpenStack-I18n] stackalytics translation stats API is broken????
by Kato, Tomoyuki 23 May '16

23 May '16

> Hmm... It seems a problem is limited to "stable-mitaka vs stable/mitaka". > > It seems 'master' version of translation stats also has a problem. okay, good information. thanks. > I translated more than 2000 words in 'master' version, but > stackalytics says I translated only 251 words. To understand the situation more exactly, which do you mean 2000 "Words" or "Messages" at Zanata? > Is it better that I stop translation? If exact stats is important for you, you should stop translation. Otherwise, translation process itself works fine. Also, I'm not sure, but we will get proper stats after stackalytics works fine. Regards, KATO Tomoyuki

9 14

[Bug 1581970] [NEW] [Install-guide] Some translated pages are missing even in pot files for liberty
by Ian Y. Choi 23 May '16

23 May '16

Public bug reported: For example, there is a original page : http://docs.openstack.org/liberty/install-guide-ubuntu/common/get_started_o… The translated pages would be :http://docs.openstack.org/liberty/ko_KR/install-guide-ubuntu/common/get_started_openstack_networking.html : http://docs.openstack.org/liberty/ja/install-guide-ubuntu/common/get_starte… ... However, the pages are not translated! Interestingly, pot files do not contain the original strings on that page : https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/common-… However, there is a original rst file : https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/common-… ** Affects: openstack-i18n Importance: Undecided Status: New ** Affects: openstack-manuals Importance: Undecided Status: New ** Also affects: openstack-manuals 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/1581970 Title: [Install-guide] Some translated pages are missing even in pot files for liberty Status in openstack i18n: New Status in openstack-manuals: New Bug description: For example, there is a original page : http://docs.openstack.org/liberty/install-guide-ubuntu/common/get_started_o… The translated pages would be :http://docs.openstack.org/liberty/ko_KR/install-guide-ubuntu/common/get_started_openstack_networking.html : http://docs.openstack.org/liberty/ja/install-guide-ubuntu/common/get_starte… ... However, the pages are not translated! Interestingly, pot files do not contain the original strings on that page : https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/common-… However, there is a original rst file : https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/common-… To manage notifications about this bug go to: https://bugs.launchpad.net/openstack-i18n/+bug/1581970/+subscriptions

2 1

[Bug 1556887] Re: Themes setting is not translated
by Rob Cresswell 21 May '16

21 May '16

It seems like the string is tranlatable, but this is an i18n issue. ** Changed in: horizon Status: Confirmed => Incomplete ** Also affects: openstack-i18n Importance: Undecided Status: New ** Changed in: horizon Status: Incomplete => Invalid ** Changed in: horizon Milestone: newton-1 => None -- 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/1556887 Title: Themes setting is not translated Status in OpenStack Dashboard (Horizon): Invalid Status in openstack i18n: New Bug description: The theme string should be translated. The screen shot is attached. To manage notifications about this bug go to: https://bugs.launchpad.net/horizon/+bug/1556887/+subscriptions

1 0

What's Up, Doc? 20 May 2016
by Lana Brindley 20 May '16

20 May '16

Hi everyone, I've been struck down by the dreaded flu this week, so it's been a bit quiet around here. I have, however, crawled out from under the tissues, throat lozenges, and episodes of Containment to pen my regular newsletter for you. See how dedicated I am to the cause? ;) The biggest updates this week have been on the API side of the ship, with the api-site bug list cleared out. Well done to Anne and Atsushi-san for the heavy lifting there. We also saw a lot of speciality team meetings kick off again this week, with more coming next week, so keep an eye on the mailing list and your ical for the projects you're interested in. We have also now hit our stride on the regular docs meetings, with the APAC meeting held this week, and the US one rolling around again next week. If you're a docs cross-project liaison, make sure you check out the timing and pick one that works for you, so we can make sure we're discussing *your* project. == Progress towards Newton == 138 days to go! Bugs closed so far: 89 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. I will also do my best to ensure it's kept up to date for each newsletter. == Speciality Team Reports == '''HA Guide: Bogdan Dobrelya''' No report this week. '''Install Guide: Lana Brindley''' Meetings start up next week: http://eavesdrop.openstack.org/#Documentation_Install_Team_Meeting Cookie cutter has been merged, repo here: http://git.openstack.org/cgit/openstack/installguide-cookiecutter/ Need to merge spec: https://review.openstack.org/#/c/310588 '''Networking Guide: Edgar Magana''' We have successfully changed the bi-weekly meeting schedule from odd to even weeks. There will not be meeting this week. Next meeting will be on June 2nd. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' Team Meeting restarted - Just me this week, I'll send a summary to the mailing list to keep everyone up to date, and if anyone is interested in joining in. Python SDK file moving - one item left from the Mitaka patch - Finding a location to move these files - dev and doc mailing list email forthcoming on where to put these files. '''Ops Guide: Shilla Saebi''' No report this week. '''API Guide: Anne Gentle''' The extension, os-api-ref, is now available via Pypi so that all projects can re-use it with test-requirements.txt. Thanks Sean Dague for this effort! Several projects have reviews in progress for their API reference conversion: glance https://review.openstack.org/#/c/312259/, manila https://review.openstack.org/#/c/313874, neutron https://review.openstack.org/#/c/314819, swift https://review.openstack.org/#/c/312315/, trove https://review.openstack.org/#/c/316381. (There are probably more but those are on my radar). Please review the response code table at https://review.openstack.org/#/c/318281/ and http://i.imgur.com/onsRFtI.png for your use cases for API reference docs. '''Config/CLI Ref: Tomoyuki Kato''' No report this week. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' Work on the slides for Training guides (https://review.openstack.org/#/c/295016/) Feedback about Upstream training in Austin (see http://eavesdrop.openstack.org/meetings/training_guides/2016/training_guide…) '''Hypervisor Tuning Guide: Blair Bethwaite Hi! I'm going to try looking after this for a while as Joe focuses on other things. Not promising much at this point beyond a little wiki gardening, but longer term I hope to align it with some activities in the scientific-wg (which I'm co-chairing with Stig Telfer), and it will probably become a point of reference for some of the activities we already have planned this cycle. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' No report this week. == Site Stats == While 90% of our readers have their browsers set to US English, just under 8% browse in Chinese, and a mere 0.15% use British English. That last one might be just me ;) == 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-05-18 Next meetings: US: Wednesday 25 May, 19:00 UTC APAC: Wednesday 1 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#20_May_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

2 1

stable-mitaka openstack-manuals is not updated?
by Akihiro Motoki 20 May '16

20 May '16

According to Zanata information, the last update of openstack-manuals stable-mitaka version in Zanata is 13/05/16 19:21 (perhaps my local time JST+09:00). The last merge of openstack-manuals stable/mitaka branch is May 17 18:16 (in my local time too). We cannot access jenkins.openstack.org now (due to the security reason), so I cannot check what happens). Akihiro

4 7

empty PO-Revision-Date in tr_TR neutron log PO file
by Akihiro Motoki 19 May '16

19 May '16

Hi team, There was a report in #-i18n channel that tr_TR neutron PO file contains empty PO-Revision-Date [1]. Can anyone dig into the detail? In addition, there seems very few folks on the IRC channel. Is it a right contact point to the i18n team? Is it better to add some warning to our document to encourage to use the mailing list? Surprisingly, the above it the first conversation in #-i18n channel in May! [1] http://eavesdrop.openstack.org/irclogs/%23openstack-i18n/%23openstack-i18n.… Akihiro

1 0

i18n meeting in IRC meeting calendar looks wrong....
by Akihiro Motoki 19 May '16

19 May '16

OpenStack IRC meeting calendar says that we have a meeting today (19 May) at 0600UTC [1]. However, i18n team doc [2] says we will have a meeting today at 1300UTC, week 3 of May. This means a meeting slot described at [2] is NOT reserved. (Don't worry. The slot is not booked as of today.) I think the reason is because OpenStack IRC meeting scheduler does not support monthly meeting schedule. It only supports weekly or bi-weekly (based on a week number in a year). It is to reduce meeting time conflicts. I have no good solution but it is better to be solved. Just FYI. Akihiro [1] http://eavesdrop.openstack.org/calendars/i18N-team-meeting.ics [2] http://docs.openstack.org/developer/i18n/i18n_team_meeting.html

1 0

Re: [OpenStack-I18n] stackalytics translation stats API is broken????
by Kato, Tomoyuki 17 May '16

17 May '16

> which is Remo(a)rm.ht > > This should be also usable on OpenStack. > > Any other suggestions Hi Remo, As of now, we maintain the user list manually. So, we should add users to the list... I'll check the list, but anyone can submit a patch for addition. http://git.openstack.org/cgit/openstack/i18n/tree/tools/zanata/translation_… Next release of Zanata will support the feature to dump user list with email. Thanks, KATO Tomoyuki

2 1

Re: [OpenStack-I18n] stackalytics translation stats API is broken????
by Ian Y. Choi 17 May '16

17 May '16

Hello Remo! Your translation count on Stackalytics is zero? If then, I think [1] and [2] will help to solve your problem :) [1] http://lists.openstack.org/pipermail/openstack-dev/2016-February/087537.html [2] http://lists.openstack.org/pipermail/openstack-dev/2016-February/087659.html With many thanks, /Ian Remo Mattei wrote on 5/16/2016 2:22 AM: > The last 2 months I translated about 400 words but stack does not even show any. It will be great to get this fixed. > > Thanks > > Inviato da iPhone > >> Il giorno 15 mag 2016, alle ore 09:56, Ian Y. Choi <ianyrchoi(a)gmail.com> ha scritto: >> >> Hello, >> >> I might have found the problem. >> >> The problem is that there can be several 'Translated' results within a week, >> however, those results are saved with the same primary key. >> >> I have just proposed https://review.openstack.org/316460 . >> >> I am not sure whether 'date' field is used on other Stackalytics sources, >> but at least, generating the primary key for translation records on record_processor.py >> does not use 'savedDate' field, as Shengjing mentioned. >> If 'date' field is used on other Stackalytics sources, please tell me, then I will change the review :) >> >> >> With many thanks, >> >> /Ian >> >> >> SJ Zhu wrote on 5/16/2016 12:14 AM: >>>> On Sun, May 15, 2016 at 10:42 PM, Ian Y. Choi <ianyrchoi(a)gmail.com> wrote: >>>> I have a question, although it is not mainly related to wrong Stackalytics >>>> stats. >>>> >>>> I have found that API 'stats/user/%s/%s..%s' >>>> and API 'stats/project/%s/version/%s/contributor/%s/%s..%s' generate >>>> different results. >>>> >>>> For example, from Apr 1 2016 to today, my count is 34320 with the first API, >>>> but the send API generates 29490 for the same period. >>>> >>>> I do know why the two APIs generate different numbers. >>>> Can statistics numbers on user API and the sum of results from each project >>>> API be different? >>> Hi all, >>> >>> Previously Stackalytics uses API >>> 'stats/project/%s/version/%s/contributor/%s/%s..%s'. >>> But I change it to 'stats/user/%s/%s..%s' in >>> https://review.openstack.org/#/c/288871/ >>> >>> I may find the BUG but I have no time to fix it these days. So I hope >>> someone to help. >>> >>> Stackalytics will get the results every week. And >>> 'stats/user/%s/%s..%s' will return >>> everyday's count. However Stackalytics seems not to sum a week's work. >>> >>> To fix it, I think we can change the way how Stackalytics uses >>> Zanata's API. Based on >>> 'stats/user/%s/%s..%s' we can get 'savedDate'. So just use the >>> 'savedDate' to display >>> on Stackalytics. I haven't read the code carefully but I think the >>> change is possible. >>> What's more we can debug the wrong results on Stackalytics more conveniently. >>> >>> But there's another question. How can we fix the old results on Stackalytics? >> >> _______________________________________________ >> OpenStack-I18n mailing list >> OpenStack-I18n(a)lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n >> >> !DSPAM:5738aa786031686312732! >> >>

3 5

stackalytics translation stats API is broken????
by Akihiro Motoki 15 May '16

15 May '16

Hi, Does stackalytics translation stats API work? I translated 7827 words this month according to Zanata homepage, but stackalytics says just 251 words translated. I translated thousands of words at least 2 or 3 days ago, so I think it should be visible at stackalytics now. I wonder what happens in Stackalytics integration..... Does anyone know the status? Akihiro

5 5

What's Up, Doc? 13 May
by Lana Brindley 13 May '16

13 May '16

= 13 May 2016 = Hi everyone, Wow, what a busy week! I've been mainly focused on the Install Guide speciality team this week, with gathering interested participants, ensuring our specs are ready to be merged, and setting a new meeting time. I'm also pleased to say that our speciality team reports make a post-Summit comeback in this newsletter. Just another reminder that all projects should update their cross-project liaison for docs on the wiki here: https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation If you're one of the lucky people nominated by your PTL to be a docs CPL, then please do your very best to attend docs meetings in your favourite timezone to make sure we hear the voice of your project when we're making documentation decisions. Details of upcoming docs meetings are at the end of this newsletter every week. On a related note, it was refreshing to read the conversation from the US meeting this week, and the associated conversation on the mailing lists about developer contributions to documentation. We'd love to find out what it is that prevents you from contributing to the docs, and what the docs team can do to make things that little bit easier for you! Reach out to us either on the dev mailing list (with [docs] in the subject line), or on the docs mailing list at openstack-docs(a)lists.openstack.org. == Progress towards Newton == 145 days to go! Bugs closed so far: 71 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. I will also do my best to ensure it's kept up to date for each newsletter. The Ops and HA Guides now exist in openstack-manuals, and the old repos have now been set to read-only. We also have the first patch in for the Install Guide 'cookie cutter' template, which is a great start! == Speciality Team Reports == '''HA Guide: Bogdan Dobrelya''' No report this week. '''Install Guide: Lana Brindley''' New meeting time proposed: https://review.openstack.org/#/c/314831/ Still need to merge final spec: https://review.openstack.org/#/c/310588/ If you're interested in helping out, add your name here: https://wiki.openstack.org/wiki/Documentation/InstallGuide#Team_members '''Networking Guide: Edgar Magana''' We are planning to resume the meeting next week. '''Security Guide: Nathaniel Dillon''' Summit Recap: https://etherpad.openstack.org/p/austin-docs-workgroup-security Good conversations around API rate limiting, OSSN in-flight, SecGuide work being prep'd (Thanks to Luke Hinds for taking this on!) Added Doc reviewer (Thanks Shilla and welcome!) Will be focusing on Neutron security '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi''' Proposed architecture guide restructure: https://review.openstack.org/#/c/311998/ Ops guide session Etherpad from Austin: https://etherpad.openstack.org/p/AUS-ops-Docs-ops-guide OpsGuide reorg: https://etherpad.openstack.org/p/PAO-ops-ops-guide-fixing Newton Plans: Review content of both guides, and delete anything out of date Review architecture of both guides, and possibly combine Ops Guide in openstack-manuals repo Gather content from Ops internal documentation '''API Guide: Anne Gentle''' All but two services have someone working on landing a migration patch in the project's repo. Read: Status on bugs and migration http://lists.openstack.org/pipermail/openstack-docs/2016-May/008624.html Read: Summit session recap http://lists.openstack.org/pipermail/openstack-dev/2016-May/094472.html '''Config/CLI Ref: Tomoyuki Kato''' Discussing documenting auto generation of config options with Oslo team. Dropped keystone command-line client from CLI reference. Keystone CLI was removed in python-keystoneclient 3.0.0 release. '''Training labs: Pranav Salunke, Roger Luethi''' Working on adding new features like PXE boot. Stabilizing current release and backends. Figuring out the zip file generation and web site/page. Chaging the meeting time to more CET/CEST friendly time. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Joe Topjian''' No report this week. '''UX/UI Guidelines: Michael Tullis, Stephen Ballard''' No report this week. == Site Stats == The interesting fact I'd like to share with you this week is that just over 25% of our viewers this month are new to the site. == 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-05-11 Next meetings: APAC: Wednesday 18 May, 00:30 UTC US: Wednesday 25 May, 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#13_May_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

1 0

where are translated documents (master/stable-mitaka) published
by Akihiro Motoki 11 May '16

11 May '16

Hi, In Zanata, we have master and stable-mitaka versions for openstack-manuals. Where are these translated documents published? For Japanese install guide, I see only http://docs.openstack.org/draft/ja/install-guide-ubuntu/ and no http://docs.openstack.org/mitaka/ja/install-guide-ubuntu/ . Which zanata version (master or stable-mitaka) corresponds to http://docs.openstack.org/draft/ja/install-guide-ubuntu/ ? Akihiro

2 2

[all][i18n] translation import: No more pot files in git trees
by Andreas Jaeger 08 May '16

08 May '16

Instead of storing the generated source translation files (*/locale/*.pot) in git and proposing them as part of the translation import, we publish these files now whenever we push to the translation server also to http://tarballs.openstack.org/translation-source/ Therefore, the source files are not needed in the git repositories anymore, the proposal bot will now - when it proposes translations - remove existing pot files. This will reduce the size of the imports significantly. Please import the translations with these removed pot files: https://review.openstack.org/#/q/status:open+topic:zanata/translations,n,z 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, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

2 1

pot files in git trees?
by Andreas Jaeger 07 May '16

07 May '16

Looking at the daily imports we do for our translations, a lot of that is importing pot files (translation source). Do we really need these for anything in the git trees? We've stopped importing those pot files which are not translated at all but import pot files that have translations and update them daily (only if there are real translations as well). I really wonder whether we need these pot files in our git repositories at all, 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

5 14

Re: [OpenStack-I18n] [OpenStack-docs] What's Up, Doc? 6 May 2016
by Matt Kassawara 07 May '16

07 May '16

One significant advantage of central documentation involves providing content in a single location with consistent structure or format that best serves the particular audience. Moving most or all documentation into project trees essentially eliminates this advantage, leaving our audiences with an impression that OpenStack consists of many loosely associated projects rather than a coherent cloud computing solution. However, as a contributor to a few other OpenStack projects who helps other developers contribute to central documentation, I can understand some of the frustrations with it. I prefer to resolve these frustrations and have some ideas that I intend to float in separate thread, but if you don't think that's possible, consider submitting a spec to change the primary purpose of the central documentation team to simply managing links to content in the project trees. On Fri, May 6, 2016 at 10:03 AM, Ildikó Váncsa <ildiko.vancsa(a)ericsson.com> wrote: > Hi Lana, > > Thanks for the summary, it's pretty good reading to catch up what happened > recently. > > I have one question, I might missed a few entries, so please point me to > the right document in this case. We had a docco session with the Telemetry > team and we agreed on moving back the documentation snippets, like for > instance the Install Guide, to the project trees is a really good step and > we're very supportive. In this sense I would like to ask about the plans > regarding the Admin guide. We have a chapter there, which is on one hand > outdated and on the other hand would be better to move under the project > trees as well. Is this plan/desire in line with your plans regarding that > document? > > Thanks, > /Ildikó > > > -----Original Message----- > > From: Lana Brindley [mailto:openstack@lanabrindley.com] > > Sent: May 06, 2016 08:13 > > To: enstack.org; OpenStack Development Mailing List; > openstack-i18n(a)lists.openstack.org > > Subject: What's Up, Doc? 6 May 2016 > > > > Hi everyone, > > > > I hope you all had a safe journey home from Summit, and are now fully > recovered from all the excitement (and jetlag)! I'm really > > pleased with the amount of progress we made this time around. We have a > definitive set of goals for Newton, and I'm confident that > > they're all moving us towards a much better docs suite overall. Of > course, the biggest and most important work we have to do is to get > > our Install Guide changes underway. I'm very excited to see the new > method for documenting OpenStack installation, and can't wait > > to see all our big tent projects contributing to docs in such a > meaningful way. Thank you to everyone (in the room and online) who > > contributed to the Install Guide discussion, and helped us move forward > on this important project. > > > > In other news, I've written a wrapup of the Austin design summit on my > blog, which you might be interested in: > > http://lanabrindley.com/2016/05/05/openstack-newton-summit-docs-wrapup/ > > > > == Progress towards Newton == > > > > 152 days to go! > > > > Bugs closed so far: 61 > > > > Because we have such a specific set of deliverables carved out for > Newton, I've made them their own wiki page: > > https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables > > Feel free to add more detail and cross things off as they are achieved > throughout the release. I will also do my best to ensure it's kept > > up to date for each newsletter. > > > > One of the first tasks we've started work on after Summit is moving the > Ops and HA Guides out of their own repositories and into > > openstack-manuals. As a result, those repositories are now frozen, and > any work you want to do on those books should be in > > openstack-manuals. > > > > We are almost ready to publish the new RST version of the Ops Guide, > there's just a few cleanup edits going in now, so make sure you > > have the right book, in the right repo from now on. This was our very > last book remaining in DocBook XML, so the docs toolchain will > > be removing DocBook XML support. See spec > https://review.openstack.org/311698 for details. > > > > Another migration note is that the API reference content is moving from > api-site to project specific repositories and api-site is now > > frozen. For more detail, see Anne's email: > http://lists.openstack.org/pipermail/openstack-docs/2016-May/008536.html > > > > == Mitaka wrapup == > > > > We performed a Mitaka retrospective at Summit, notes are here: > https://etherpad.openstack.org/p/austin-docs-mitakaretro > > > > In particular, I'd like to call out our hard working tools team Andreas > and Christian, all our Speciality Team leads, and the Mitaka release > > managers Brian and Olga. Well done on a very successful release, > everyone :) > > > > Total bugs closed: 645 > > > > == Site Stats == > > > > Thanks to the lovely people at Foundation (thanks Allison!) I now have > access to more stats than I could possibly guess what to do > > with, and I'm hoping to be able to share some of these with you through > the newsletter. If there's something in particular you would > > like to see, then please let me know and I'll endeavour to record it > here! > > > > So far I can tell you that docs.openstack.org had 1.63M unique > pageviews in April, down slightly from 1.72M in March, and the average > > session duration is just over six minutes, looking at just under 4 pages > per session. > > > > == Doc team meeting == > > > > Next meetings: > > > > We'll be restarting the meeting series next week. > > > > Next meetings: > > US: Wednesday 11 April, 19:00 UTC > > APAC: Wednesday 18 April, 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#6_May_2016 > > > > -- > > Lana Brindley > > Technical Writer > > Rackspace Cloud Builders Australia > > http://lanabrindley.com > > _______________________________________________ > OpenStack-docs mailing list > OpenStack-docs(a)lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs >

1 0

What's Up, Doc? 6 May 2016
by Lana Brindley 06 May '16

06 May '16

Hi everyone, I hope you all had a safe journey home from Summit, and are now fully recovered from all the excitement (and jetlag)! I'm really pleased with the amount of progress we made this time around. We have a definitive set of goals for Newton, and I'm confident that they're all moving us towards a much better docs suite overall. Of course, the biggest and most important work we have to do is to get our Install Guide changes underway. I'm very excited to see the new method for documenting OpenStack installation, and can't wait to see all our big tent projects contributing to docs in such a meaningful way. Thank you to everyone (in the room and online) who contributed to the Install Guide discussion, and helped us move forward on this important project. In other news, I've written a wrapup of the Austin design summit on my blog, which you might be interested in: http://lanabrindley.com/2016/05/05/openstack-newton-summit-docs-wrapup/ == Progress towards Newton == 152 days to go! Bugs closed so far: 61 Because we have such a specific set of deliverables carved out for Newton, I've made them their own wiki page: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. I will also do my best to ensure it's kept up to date for each newsletter. One of the first tasks we've started work on after Summit is moving the Ops and HA Guides out of their own repositories and into openstack-manuals. As a result, those repositories are now frozen, and any work you want to do on those books should be in openstack-manuals. We are almost ready to publish the new RST version of the Ops Guide, there's just a few cleanup edits going in now, so make sure you have the right book, in the right repo from now on. This was our very last book remaining in DocBook XML, so the docs toolchain will be removing DocBook XML support. See spec https://review.openstack.org/311698 for details. Another migration note is that the API reference content is moving from api-site to project specific repositories and api-site is now frozen. For more detail, see Anne's email: http://lists.openstack.org/pipermail/openstack-docs/2016-May/008536.html == Mitaka wrapup == We performed a Mitaka retrospective at Summit, notes are here: https://etherpad.openstack.org/p/austin-docs-mitakaretro In particular, I'd like to call out our hard working tools team Andreas and Christian, all our Speciality Team leads, and the Mitaka release managers Brian and Olga. Well done on a very successful release, everyone :) Total bugs closed: 645 == Site Stats == Thanks to the lovely people at Foundation (thanks Allison!) I now have access to more stats than I could possibly guess what to do with, and I'm hoping to be able to share some of these with you through the newsletter. If there's something in particular you would like to see, then please let me know and I'll endeavour to record it here! So far I can tell you that docs.openstack.org had 1.63M unique pageviews in April, down slightly from 1.72M in March, and the average session duration is just over six minutes, looking at just under 4 pages per session. == Doc team meeting == Next meetings: We'll be restarting the meeting series next week. Next meetings: US: Wednesday 11 April, 19:00 UTC APAC: Wednesday 18 April, 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#6_May_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com

1 0

Newton Design Summit summary
by Kato, Tomoyuki 05 May '16

05 May '16

Hi everyone, Here is Newton Design Summit I18n sessions summary. I18n Design Summit ------------------ * Thursday 2016-04-28 13:30 - 15:00 I18n workshop: translation processes and tools https://etherpad.openstack.org/p/austin-i18n-workshop * Friday 2016-04-29 9:00 -12:30 I18n Contributors meetup https://etherpad.openstack.org/p/austin-i18n-meetup Summary ------- * Newton cycle translation priority - Dashboard and plug-ins: require ALL with appropriate priority [TBD] - Documentation: install-guide, user-guide, api-quick-start - Glossary (not yet implemented) * I18n Guide revision - String freeze policy - How to translate release notes - How to archiving ATC, coordinators and core reviewers * Release notes translation - At now, we have translation resources at Zanata, which is named "releasenotes" at each project - Discussion with Doug Hellman, Release Management team PTL - publish to http://docs.openstack.org/<lang>/releasenotes/<project>/ - create each language index page, manually or automatically - each release note page doesn't contain language selector * Translation check site - patch review is under going. need review * Zanata upgrade - we need more time because it does not work fine * Automatic generation of ATC list - First, need to upgrade Zanata to version 3.9 or later * Glossary management - First, need to upgrade Zanata to version 3.9 or later - Need to decide management process, file formats, and so on * Improve Stackalytics - Add "translation review" count as new metrics - Update the stats daily, not weekly, as others * Docs translation publication - Simplify the maintainance process of traslated docs publication - Need to work with docs and infra team * Bug management - Email bug report to i18n ML when it is submitted * Transifex closure [Done] For more information, please see the Etherpad pages. -- KATO Tomoyuki

3 3

[i18n] Meeting reminder
by Kato, Tomoyuki 05 May '16

05 May '16

Hi team, This is a meeting reminder. I think it will be a short meeting, mainly for summit non-attendency. Kato

1 0