- OpenStack-I18n - lists.openstack.org

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

26 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 22 May '16

22 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 19 May '16

19 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 16 May '16

16 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 16 May '16

16 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 14 May '16

14 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 12 May '16

12 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 10 May '16

10 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 07 May '16

07 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 06 May '16

06 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 05 May '16

05 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 04 May '16

04 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 04 May '16

04 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

Create new language team called "Hinglish"
by Nitin Madhok 03 May '16

03 May '16

Hello, I’m Nitin Madhok working for Clemson University and currently contributing to various open source projects. I’m multi lingual and can read/write/speak the following languages: English(US) English(UK) French Hindi Hinglish Punjabi I want to create a language team called “Hinglish” (https://en.wikipedia.org/wiki/Hinglish <https://en.wikipedia.org/wiki/Hinglish>). My ID on Zanata is nmadhok -- Thanks, Nitin Madhok Clemson University

3 3

Fw: [OpenStack-docs] Freezing operations-guide repository
by KATO Tomoyuki 02 May '16

02 May '16

Hi team, Docs team decided to move operations guide into openstack-manuals repo. Also, XML DocBook is freezed, so we should not translate it. i.e. operations-guide/openstack-ops at Zanata. Stay tuned, the newer operations guide in RST format will appear at openstack-manuals project at Zanata, which will occur soon. KATO Tomoyuki ----------------------- Original Message ----------------------- Since we have now imported the RST ops-guide in openstack-manuals, let's freeze the operations-guide repository. We do not need to make any further edits there, any further updates should be done to the RST guide. I'm working on retiring the repository following the process documented at http://docs.openstack.org/infra/manual/drivers.html#retiring-a-project . Once this is done, the repository will be completely read-only. For that, I will propose a few final cleanup changes. So, let's do now: * Freeze repo - no more approvals for it (besides retiring). * Retire repository 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 _______________________________________________ OpenStack-docs mailing list OpenStack-docs(a)lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

1 0

FW: [Bug 1573514] [NEW] Typos in Italian Mitaka translation
by Kato, Tomoyuki 22 Apr '16

22 Apr '16

Hi Italian team, KATO Tomoyuki > -----Original Message----- > Title: > Typos in Italian Mitaka translation > > Status in openstack i18n: > New > > Bug description: > Zanata proposed another update for mitaka neutron Italian translation: > https://review.openstack.org/#/c/309280/ > > There are several concerns I have here. > > First, it seems that the change has some typos (e.g. using a ¥ character while the language does not use it at all). > Second, the change removes authorship for multiple contributors. I suspect it's not expected.

2 1

Re: [OpenStack-I18n] IRC meeting this week
by Kato, Tomoyuki 21 Apr '16

21 Apr '16

> Thank you, Kato-san. > I'm not able to attend the meeting this time because of a conflict. > I have added some topics to austin-i18n-workshop. quick short response. > In total we have 2 i18n related sessions, 40-minute austin-i18n-workshop 90-minutes, isn't it? https://www.openstack.org/summit/austin-2016/summit-schedule/events/7707 Kato > and a half day austin-i18n-meetup. > I see there are a long list of topics in austin-i18n-workshop. > I suggest we move some topics to austin-i18n-meetup in order to have > thorough discussions for every topic. > Maybe we move glossary and bug management discussions to > austin-i18n-meetup. > And in austin-i18n-workshop, we focus on Zanata, translation check website > and stackalytics. > > Best regards > Ying Chun Guo (Daisy) > > > "Kato, Tomoyuki" <kato.tomoyuki(a)jp.fujitsu.com> wrote on 04/19/2016 > 11:12:05 AM: > > > From: "Kato, Tomoyuki" <kato.tomoyuki(a)jp.fujitsu.com> > > To: "'openstack-i18n(a)lists.openstack.org'" <openstack- > > i18n(a)lists.openstack.org> > > Date: 04/19/2016 11:14 AM > > Subject: [OpenStack-I18n] IRC meeting this week > > > > Hi team > > > > We will have IRC meeting at UTC 13:00 UTC Thursday in > #openstack-meeting. > > > > The agenda is > > > > * Summit Planning > > - https://etherpad.openstack.org/p/austin-i18n-workshop > > - https://etherpad.openstack.org/p/austin-i18n-meetup > > > > If you have more topics, feel free to email. > > > > Regards, > > KATO Tomoyuki (katomo) > > > > _______________________________________________ > > OpenStack-I18n mailing list > > OpenStack-I18n(a)lists.openstack.org > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n > > >

2 1

IRC meeting this week
by Kato, Tomoyuki 18 Apr '16

18 Apr '16

Hi team We will have IRC meeting at UTC 13:00 UTC Thursday in #openstack-meeting. The agenda is * Summit Planning - https://etherpad.openstack.org/p/austin-i18n-workshop - https://etherpad.openstack.org/p/austin-i18n-meetup If you have more topics, feel free to email. Regards, KATO Tomoyuki (katomo)

2 1

translation syncronization disabled due to broken Babel release
by Andreas Jaeger 17 Apr '16

17 Apr '16

A heads up and a request for advise: Babel 2.3.3 release broke extraction of log level messages from strings and extracted instead of e.g. "_LW" the default "_". So, the proposal job removed all content for that. Fortunately, Zanata will keep the strings, so once an upload with a fixed Babel happens, this should be fine again. See https://review.openstack.org/#/c/304985/ for one example - the error manifests with all pot files having exactly the same content. But I wanted to be safe and since babel 2.3.2 broke horizon and now 2.3.3 breaks python projects, I have - as teemporary measure - disabled translation sync completely to buy us time to evaluate what to do. There's a requirements change to update versions (blocking all broken babel releases): https://review.openstack.org/#/c/305000 Upstream bug report https://github.com/python-babel/babel/issues/388 And one way of working around it the bug is not using "python setup.py" but "pybabel" directly for python projects - like we do for django already. This needs testing and review - and some updates (see review comment): https://review.openstack.org/305043 We can also wait for Babel 2.3.4 release - and test first that it works as desired. Advise on which way to go forward as well as testing and review of 305043 are welcome! 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 3