- OpenStack-I18n - lists.openstack.org

Japanese Install Guides publishing - and openstack-doc-tools 0.30.1
by Andreas Jaeger 27 Aug '15

27 Aug '15

Congrats to the Japanese translation team! We now have the RST Install Guides translated and up for review on http://docs.openstack.org/draft/draft-index.html To properly publish the Debian version of it, we had to release openstack-doc-tools 0.30.1. 0.30.1 fixes also one annoying issue a few of you fall into: When you run tox -e checklang, files were changed and some of you committed them by accident. This will not happen anymore, checklang now cleans up properly. 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

4 3

Re: [Openstack-i18n] Zanata trial starts ! Please register and try - requirements before production
by Ying Chun Guo 24 Aug '15

24 Aug '15

Thank you, Elizabeth. If you could manipulate user database, it would be great. Even a coordinator gets a OpenStack ID, he/she still needs to do the first time "log in" and then create his/her profiles, then his/her user id is shown up in the user list. If his/her user id doesn't appear in the user list, I could not assign him/her any roles, except waiting for him/her to log in. The same thing happens when a coordinator wants to create his/her language team. The coordinator has to wait for the team members to do the first time "log in". There are 40+ language teams. So creating language teams will be a time consuming work. In September, we don't have much time to wait. If you could import database, it will be a one minute task. That will save us a lot of time. Best regards Ying Chun Guo (Daisy) "Elizabeth K. Joseph" <lyz(a)princessleia.com> wrote on 08/22/2015 01:24:49 AM: > From: "Elizabeth K. Joseph" <lyz(a)princessleia.com> > To: Ying Chun Guo/China/IBM@IBMCN > Cc: Openstack-i18n Openstack-i18n <openstack-i18n(a)lists.openstack.org> > Date: 08/22/2015 01:25 AM > Subject: Re: [Openstack-i18n] Zanata trial starts ! Please register > and try - requirements before production > > On Fri, Aug 21, 2015 at 10:17 AM, Elizabeth K. Joseph > <lyz(a)princessleia.com> wrote: > > As far as I know, there is > > no export tool and the whole process would be raw database > > manipulation and I don't know all the things that I'd need to change, > > it's a complicated database. I'll follow up with Carlos to confirm. > > Just read the back scroll in the #zanata channel, as I suspected it > does sound like the API won't work for us, but manual editing of the > database will: > > 00:33:31 < camunoz> well, I don't think you need a list (unless you > want to filter out some users). We could just take an extract of the > relevant tables from the database right before the move, and then dump > that extract onto the new database > > So with it sound like he knows the right sections to export from the > data to make this possible. I'll work with him next week to come up > with a detailed plan. > > -- > Elizabeth Krumbach Joseph || Lyz || pleia2 >

1 0

Re: [Openstack-i18n] Zanata trial starts ! Please register, and try - requirements before production
by Carlos Munoz 24 Aug '15

24 Aug '15

Hi, Just a couple of points from some discussions that I've had with Daisy and Elizabeth in the past few days. 1. About Zanata's short session timeout: I did some research and unfortunately the most recent versions of Wildfly removed the capability of changing the session timeout outside of the application. What this means is that in order to increase we are going to need to modify an xml file inside the Zanata package. This is a minimal change that can be puppetized if needed. I will try to add this as a permanent change in Zanata for future releases. 2. About the migration of user accounts from the Development server to a production one. My recommendation is that we do a copy of the relevant tables in the dev server directly onto production. This way the full registered user base will be copied over. We could even look at doing the same for language teams if needed. Let me know if there are any questions. Regards, -- Carlos A. Munoz Software Engineering Supervisor Engineering - Internationalization Red Hat

1 0

admin-guide-cloud is converted to RST
by Andreas Jaeger 22 Aug '15

22 Aug '15

The Cloud Admin Guide resource is now migrated from XML to RST, admin-guide-cloud is therefore now fully RST. The guide currently has no full translations and will now get revised - so don't give it any priority for now, 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

1 0

IRC meeting tomorrow
by Ying Chun Guo 21 Aug '15

21 Aug '15

Hello, team We will have the IRC meeting at UTC 1300 in the channel #openstack-meeting, on August 20th. I'm going to cover following topics: * I18n sessions in Tokyo summit * Open discussions If you have other topics, feel free to propose. Best regards Ying Chun Guo (Daisy)

2 1

Meeting minutes of last IRC meeting - must read
by Ying Chun Guo 21 Aug '15

21 Aug '15

Hello, team There are several important topics mentioned in last IRC meeting, which I would let you know. 1. I18n sessions in Tokyo summit I have booked several time slots for I18n meeting. Now they are opening for proposals. If you have any topics related with I18n and want to have face to face discussion in Tokyo summit, please propose your topics here: https://etherpad.openstack.org/p/tokyo-i18n-sessions If the time slots are not suitable for you, please let me know before Aug. 24. As to the summit registration codes, after the ATC list is approved by TC, I will continue the process to get discount codes for the ATCs. 2. Liberty translation According to the release schedule of Liberty, the feature freeze date is Sep. 1-3, the official release date is Oct. 15th. So when the Zanata production environment is ready, the translation team have to kick off Liberty translations as soon as possible. The deadline is usually 7-10 days before the final release date, although nobody knows the exact date now. So we will have a busy September. Please arrange your time in advance. Before Liberty translation starts, the most important thing is to move the whole team to Zanata ! Please help to encourage your team to sign the CLA, register in Zanata, join the language team, and get familiar with Zanata. More details information could be found here: https://wiki.openstack.org/w/index.php?title=I18nTeam/become-a-official-tra… Please distribute to your team. 3. IBM wants to contribute its professional translations IBM had contributed its professional translations to upstream before, in two old releases. They keep on the update of translations in downstream, now the latest translations in their hands are for Kilo. They want to contribute these translations to upstream, just as what they did before. The translations are for projects: ceilometer glance heat nova ironic neutron cinder keystone swift ( note that horizon is not included. ) and for languages: de es fr it ja ko_KR pt_BR ru zh_CN zh_TW. These translations were translated by professional translators and tested under Kilo release. The plan is to add translations where the community translations don't not exist. The existing translations won't be overwritten. If you have any concerns, please let me know. Best regards Ying Chun Guo (Daisy) [1] https://wiki.openstack.org/wiki/Liberty_Release_Schedule

1 0

Zanata trial starts ! Please register and try.
by Ying Chun Guo 21 Aug '15

21 Aug '15

Hello, team Infra team have set up the Zanata test instance on top of openstack infrastructure. OpenStack projects, together with the translations, in Transifex have been moved to Zanata test instance now. So we could start the Zanata trial now. https://translate-dev.openstack.org/ (it's a self-signed certificate, so you will be presented with a warning, it's ok) 1. Log in You can use your OpenStack ID to log in. If you don't have, register here: https://www.openstack.org/join/register I will suggest to register with your company email, which will help your company to get the credit. If you don't want to, that's OK. :)) When you log in, you will be required to fill in your profile. Then you can start the trial. 2. Join a translation team List all languages by clicking "Languages" on the top. Click your language, you will go to that language page. On the right of the language name, there is a button "^..." which means "more actions". Click on the button and select "Request to Join Team". Then wait for your request to be approved. When it is approved, you will get the email notification. 3. Manage your team member if you are a coordinator If you are assigned a coordinator role, you will be able to see "Add Team Members" in the language page after clicking "^..." (more actions). You can only search users by user id. You can assign a member different roles (translator, reviewer, coordinator) 4. Translate After you have a language team, list the projects by clicking "Projects" on the top. Select a project, select a version, then you can translate. 5. Feedback We hope to get your feedback to the Zanata trial. If you find any resources/translations missed, which is in Transifex but not in Zanata, please let us know. If you find any bugs, please let us know. If you don't know how to operate, please let us know. We use https://etherpad.openstack.org/p/zanata-feedback to track the feedback. Reference link: Documentation for Zanata can be found here: http://docs.zanata.org/en/release/ Specifically for translators: http://docs.zanata.org/en/release/user-guide/translator-guide/ Note: 1. This is only a trial. All the projects, teams, and translations will not be preserved. This test instance will be wrapped off when the trail is done. Then infra team will create a formal website. You will be notified when we officially move to Zanata. Now if you want to translate, please still use Transifex for your primary translations work. Your registration to OpenStack ID will be preserved for ever. When we officially move to Zanata, you don't need to register again. But we need to create the language team once more. 2. Anyone can create projects, for the sake of this demonstration please don't create your own Thanks! Best regards Ying Chun Guo (Daisy)

8 22

Re: [Openstack-i18n] Install Guide: Converted to RST
by Andreas Jaeger 21 Aug '15

21 Aug '15

On 2015-08-20 16:59, Andreas Jaeger wrote: > The Install Guide is now completely RST and the resource "install-guide" > in transifex has been updated for translation of the RST files. > > Next guide to move to RST is "admin-guide-cloud", > > Andreas Note that as part of this change, we're not publishing the translated DocBook XML Install Guides anymore. Once we have Zanata and can publish from release branches - and have sufficient translation - we can publish again, 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

1 0

Re: [Openstack-i18n] Install Guide: Converted to RST
by Ying Chun Guo 21 Aug '15

21 Aug '15

Thank you for the update. The new install guide is for which release ? Best regards Ying Chun Guo (Daisy) Andreas Jaeger <aj(a)suse.com> wrote on 08/20/2015 10:59:47 PM: > From: Andreas Jaeger <aj(a)suse.com> > To: "openstack-i18n(a)lists.openstack.org" <openstack-i18n(a)lists.openstack.org> > Date: 08/20/2015 11:00 PM > Subject: [Openstack-i18n] Install Guide: Converted to RST > > The Install Guide is now completely RST and the resource "install-guide" > in transifex has been updated for translation of the RST files. > > Next guide to move to RST is "admin-guide-cloud", > > 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 > > > _______________________________________________ > Openstack-i18n mailing list > Openstack-i18n(a)lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n

2 1

What's Up, Doc? 21 August 2015 (Early edition)
by Lana Brindley 20 Aug '15

20 Aug '15

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi everyone, First of all, apologies for missing last week's newsletter: I got so caught up in the documentation swarm happening here in Brisbane that it totally slipped my mind! To make up for it, have this week's newsletter a day early :) In swarm news, the two days ran extremely smoothly, much to the credit of Suyog, Brian, and Alex who did the heavy lifting of preparation and organisation. While we focused largely on copy editing, we also had a lot of great discussion about the overall architecture of the book, and now have a draft plan ready for Mitaka, which Darren is driving with the Ops/Arch Guide speciality team. While last week was all about the docs swarm, this week has been doing the final cleanup on our newly converted RST books. The Security Guide is now up, and the Cloud Admin and HA Guides aren't far behind. We're also about to start testing the Install Guide, now that its conversion is complete. Well done to all the people who have helped out on these efforts, great job! == Progress towards Liberty == 55 days to go! * RST conversion: ** Install Guide: Conversion is done, testing to begin soon. ** Cloud Admin Guide: is complete! The new version will be available on docs.openstack.org very soon. ** HA Guide: is also done, and will available on the site soon. ** Security Guide: is complete, and live: http://docs.openstack.org/security-guide/ * User Guides information architecture overhaul ** Some user analysis has begun, with a new blueprint to land soon. * Greater focus on helping out devs with docs in their repo ** Work has picked up on the Ironic docs again. * Improve how we communicate with and support our corporate contributors ** If you currently work on documentation for a company that would like to improve their upstream commits for documentation, please contact me! * Improve communication with Docs Liaisons ** I'm very pleased to see liaisons getting more involved in our bugs and reviews. Keep up the good work! * Clearing out old bugs ** Sadly, no action on the spotlight bugs again this week. I'll keep the current three bugs for this week, to give everyone a little more time. == RST Migration == That's it! We're done! Do you have ideas for which book should be next? Have a think on it, and we'll discuss this at Summit. == Training Guides == I'm happy to announce that the Training Labs are now in their own repo, and are considered a documentation speciality team. Well done to Pranav, Matjaz, Sayali, and Roger for driving this effort. == Countdown to Summit == With the Liberty release less than two months away, that means it's nearly Summit time again: https://www.openstack.org/summit/tokyo-2015/ Here's a few things you might want to be thinking about: * Do you need a visa to visit Japan? If so, you need to be organising this NOW: https://www.openstack.org/summit/tokyo-2015/tokyo-and-travel/#visa * Do you have an ATC pass? If you haven't received your pass yet, and you're an ATC, please contact me so I can chase this up for you. Remember to use your ATC discount code before 31 August to make sure you get the full price discounted. == Doc team meeting == The APAC meeting was held this week. Read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2015-08-19 The next meetings are: US: Wednesday 26 August, 14:00:00 UTC APAC: Wednesday 2 September, 00:30: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… == Spotlight bugs for this week == Let's give these three a little more love: https://bugs.launchpad.net/openstack-manuals/+bug/1257018 VPNaaS isn't documented in cloud admin https://bugs.launchpad.net/openstack-manuals/+bug/1257656 VMware: add support for VM diagnostics https://bugs.launchpad.net/openstack-manuals/+bug/1261969 Document nova server package - -- Remember, if you have content you would like to add to this newsletter, or you would like to be added to the distribution list, please email me directly at openstack(a)lanabrindley.com, or visit: https://wiki.openstack.org/w/index.php?title=Documentation/WhatsUpDoc Keep on doc'ing! Lana - -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQEcBAEBAgAGBQJV1TwWAAoJELppzVb4+KUylDUIALVRDpsMU+xM+7x8AsJKfnwv BRmGvUQWrrneBdx99b4Dyq/qianUPxz0hHjdchdeA37JfQYGiKoaVWVR1QAj5aPs WSg5/KRKI8cjHdfGDo7o0NhFIl2d9cyLj55xXap89QWSZvGoRSn8pXIibRoGd+1t Pp4RpxqftB8BYTlDkrdePYDIb0X+um3CJ2a/0DwuKUUVfn5zWxt9pOBYrYuqyFbK fUmI0LzRtopT+hmk02eHaefFzq+nQg5RO64osxd3JG/Zibgb8nIqw6eTjMBLvLs8 aPiNQ5ZSi5dwwRfy3pX8XpM4bl9iXOjhEAxtBT+6Zen4MvaTLehXbnoQ+ooETcQ= =ul61 -----END PGP SIGNATURE-----

1 0