- OpenStack-I18n - lists.openstack.org

Security Guide RST published
by Andreas Jaeger 12 Aug '15

12 Aug '15

The Security Guide has been converted to RST and we renamed it. So, the security-guide resource is now the resource for the RST guide. security-guide-rst is read-only now and not used anymore, Andreas -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

2 3

New Oslo projects for translation
by Davanum Srinivas 11 Aug '15

11 Aug '15

Andreas, Team, Can you please add the following projects to Transifex? * oslo.cache * oslo.policy * oslo.reports * oslo.service Thanks, Dims -- Davanum Srinivas :: https://twitter.com/dims

2 2

What's Up, Doc? 7 August 2015
by Lana Brindley 07 Aug '15

07 Aug '15

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi everyone, Welcome to August! Today we can finally announce that the Cloud Admin Guide is now completely converted to RST! I have been doing a fair bit of 'behind the scenes' work this week, focusing mainly on Training Guides and our docs licensing. We also welcome another new core team member this week, and for those of you in the APAC region, get ready for the Docs Swarm in Brisbane, where we'll be working on restructuring the Architecture Design Guide. == Progress towards Liberty == 68 days to go! * RST conversion: ** Install Guide: Conversion is nearly done, sign up here: https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Mi… ** Cloud Admin Guide: is complete! The new version will be available on docs.openstack.org very soon. ** HA Guide: is also nearly done. Get in touch with Meg or Matt: https://wiki.openstack.org/wiki/Documentation/HA_Guide_Update ** Security Guide: Conversion is now underway, sign up here: https://etherpad.openstack.org/p/sec-guide-rst * User Guides information architecture overhaul ** Waiting on the RST conversion of the Cloud Admin Guide to be complete * Greater focus on helping out devs with docs in their repo ** Work has stalled on the Ironic docs, we need to pick this up again. Contact me if you want to know more, or are willing to help out. * Improve how we communicate with and support our corporate contributors ** I have been brainstorming ideas with Foundation, watch this space! * 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 this week. Perhaps we're all worn out from the RST conversions? I'll keep the current three bugs for this week, to give everyone a little more time. == RST Migration == With the Cloud Admin Guide complete, we are now working on the Install Guide, HA Guide, and the Security Guide. If you would like to assist, please get in touch with the appropriate speciality team: * Install Guide: ** Contact Karin Levenstein <karin.levenstein(a)rackspace.com> ** Sign up here: https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Mi… * HA Guide ** Contact Meg McRoberts <dreidellhasa(a)yahoo.com> or Matt Griffin <me(a)mattgriffin.com> ** Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide * Security Guide ** Contact Nathaniel Dillon <nathaniel.dillon(a)hp.com> ** Info: https://etherpad.openstack.org/p/sec-guide-rst For books that are now being converted, don't forget that any change you make to the XML must also be made to the RST version until conversion is complete. Our lovely team of cores will be keeping an eye out to make sure loose changes to XML don't pass the gate, but try to help them out by pointing out both patches in your reviews. == Training Guides == I've been working with the Training Guides group and the docs core team to determine the best way to move forward with the Training Guides project. At this stage, we're planning on breaking the project up into a few distinct parts, and bringing Training Guides back into the documentation group as a speciality team. If you have any opinions or ideas on this, feel free to contact me so I can make sure we're considering all the options. == APAC Docs Swarm == We're less than a week away from the APAC doc swarm! This time we'll be working on the Architecture Design Guide. It's to be held at the Red Hat office in Brisbane, on 13-14 August. Check out http://openstack-swarm.rhcloud.com/ for all the info and to RSVP. == Core Team Changes == This month, we welcome KATO Tomoyuki on to our docs core team. Thanks for all your hard work Tomoyuki-san, and welcome to the team! == Doc team meeting == The APAC meeting was held this week. Read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2015-08-05 The next meetings are: US: Wednesday 12 August, 14:00:00 UTC APAC: Wednesday 19 August, 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 oxygen: 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 iQEcBAEBAgAGBQJVxFJBAAoJELppzVb4+KUy9d8IAKgEM8succPKaPrmFzY1V5cS 402VF4uR8XzelkkJWQWCG6U1OWP+m6X3n5SFuFraZKLCQmUXL0HG0L3PrLB7eryT 0VKDiGTKcPW5MukLUtKRdkqoyJ5GYWTO6oT3l07tqkCWuGTI5Chp0gcOJDG2spLi D8BAGAlQ42E+2NqgaxTmU+7uE60CyzXBXsquLcxwnuRr1ih18S5N8Cxkks17XOkL XSejUisrRVX4lpVdCZw/VdXCBQ6+4YLC9xdnfpPWgXsAc2npPdrUfwju9Tf4JHxF OmrAQ1igdYDd3KJP4H6tQcIabN5HZuAseOEGZFtWu6bnteyh/1Vz2RI+lUBNo/E= =TmFH -----END PGP SIGNATURE-----

1 0

oslo.i18n now support contextual and plural messages
by Peng Wu 06 Aug '15

06 Aug '15

Hi, The oslo.i18n library already supports standard gettext message. Now the contextual and plural messages are also supported now, which is needed for better translation quality. For more information: http://git.openstack.org/cgit/openstack/oslo.i18n/tree/doc/source/gui delines.rst#n18 http://git.openstack.org/cgit/openstack/oslo-specs/tree/specs/liberty /more-gettext-support.rst Feel free to comment it. Best Regards, Peng Wu

1 0

Admin Guide Cloud RST conversion
by Andreas Jaeger 05 Aug '15

05 Aug '15

The Admin Guide Cloud has been converted to RST and the team is doing the final review now. I've created a new resource admin-guide-cloud-rst for translation and synced the existing matching translations over. We will soon remove the old admin-guide-cloud - and afterwards move admin-guide-cloud-rst to admin-guide-cloud. For now I suggest to not touch these guides and wait until we're finished with the final cleanup. And then I'll send out a note 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, Dilip Upmanyu, 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 05 Aug '15

05 Aug '15

Hello, team We will have the IRC meeting at UTC 0600 in the channel #openstack-meeting, on August 6th. I'm going to cover following topics: * Prioritise requirements/bugs of Zanata server * Progress track on two bp: "translation check website" and "translation metric" * Open discussions If you have other topics, feel free to propose. Best regards Ying Chun Guo (Daisy)

1 0

Glance needs some fields in JSON files translated.
by Okuma, Wayne 05 Aug '15

05 Aug '15

Hi i18n team, My name is Wayne Okuma. I work with the Glance team and am focused on Glance's Metadata Definition (metadef) Library support. We currently have ~20 metadef JSON files which are loaded into the Glance database. We would like to have some of the fields in the JSON files localized. I'm not clear what the process is for getting the glance.po file uploaded to Transifex. I have a pybabel extractor that can generate a "glance-json.pot" with just the fields I'm interested in localizing and am wondering what the steps would be for me to get it uploaded to Transifex. Also, although I can manually run the extraction routine, is there a way this can be done automatically? Thanks for any information you can provide. Wayne Okuma

3 4

Renaming IRC channel?
by Adrien Cunin 02 Aug '15

02 Aug '15

Hi, Following a recent discussion, I was going to make sure the team IRC channel is logged at http://eavesdrop.openstack.org/. Then I realized the IRC channel name #openstack-translation is not really consistent with the project team name "i18n" and the mailing-list name "openstack-i18n". Would it make sense to rename the IRC channel to #openstack-i18n? Thanks, Adrien

3 9

What's Up, Doc? 31 July 2015
by Lana Brindley 31 Jul '15

31 Jul '15

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi everyone, This week, like last, was all about the RST conversion. With just a 48 hour long sprint, the Install Guide is almost complete! A hearty congratulations to everyone who contributed. One of the interesting things about doing all these conversions is the amount of conversation it has started about our conventions, and I'm pleased to see that we're really starting to get a feel for how RST can work for us, and what we can demand of it. It's also great to see some related changes to the sphinx theme that handles how we display our shiny RST books. == Progress towards Liberty == 75 days to go! * RST conversion: ** Install Guide: Conversion is nearly done, sign up here: https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Mi… ** Cloud Admin Guide: is nearly done. Sign up here: https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Mig… ** HA Guide: is also nearly done. Get in touch with Meg or Matt: https://wiki.openstack.org/wiki/Documentation/HA_Guide_Update ** Security Guide: Conversion is now underway, sign up here: https://etherpad.openstack.org/p/sec-guide-rst * User Guides information architecture overhaul ** Waiting on the RST conversion of the Cloud Admin Guide to be complete * Greater focus on helping out devs with docs in their repo ** Work has stalled on the Ironic docs, we need to pick this up again. Contact me if you want to know more, or are willing to help out. * Improve how we communicate with and support our corporate contributors ** I have been brainstorming ideas with Foundation, watch this space! * 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 ** Thanks to Brian for picking up one of the spotlight bugs from last week. Three new bugs to look at this week. == RST Migration == The next books we are focusing on for RST conversion are the Install Guide, Cloud Admin Guide, HA Guide, and the Security Guide. If you would like to assist, please get in touch with the appropriate speciality team: * Install Guide: ** Contact Karin Levenstein <karin.levenstein(a)rackspace.com> ** Sign up here: https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Mi… * Cloud Admin Guide: ** Contact Brian Moss <kallimachos(a)gmail.com> & Joseph Robinson <joseph.r.email(a)gmail.com> ** Sign up to help out here: https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Mig… * HA Guide ** Contact Meg McRoberts <dreidellhasa(a)yahoo.com> or Matt Griffin <me(a)mattgriffin.com> ** Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide * Security Guide ** Contact Nathaniel Dillon <nathaniel.dillon(a)hp.com> ** Info: https://etherpad.openstack.org/p/sec-guide-rst For books that are now being converted, don't forget that any change you make to the XML must also be made to the RST version until conversion is complete. Our lovely team of cores will be keeping an eye out to make sure loose changes to XML don't pass the gate, but try to help them out by pointing out both patches in your reviews. == Docs Tools == Thanks to Dave for picking up a bug this week and adding a navigation bar to the sidepane of the docs theme for our RST books. We should be releasing an updated docs theme shortly so you can play with this new functionality. In the meantime, if you have suggestions for the docs theme, raise the issue on the docs mailing list, or go right ahead and create a bug for it. == APAC Docs Swarm == The APAC team have been working on holding another doc swarm, this time working on the Architecture Design Guide. It's to be held at the Red Hat office in Brisbane, on 13-14 August. Check out http://openstack-swarm.rhcloud.com/ for all the info. == Doc team meeting == The US meeting got cancelled this week. The next meetings are: APAC: Wednesday 5 August, 00:30:00 UTC US: Wednesday 12 August, 14:00: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 == Three new spotlight bugs for you to sink your teeth into: 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 iQEcBAEBAgAGBQJVuySjAAoJELppzVb4+KUymgUH/Rfh9srfYeY+tzgE1lHm5XW1 USac40LqOOT9TtBtepqxTO3JlqNt5DusYy/TPMp5U0ctqOuzy4UQPPR0WljjBSNe nV3uspX6CNzhbWGAtF96a5Tv/d7VDyWvc8p8VyHV18dgOk5rgtbO7IixgoFh9tWs MQoEvhsH3PwK9UTk0+LJZ2qlYX1NCXJH1KeTrqq/uy76EUFGjSfrNHWu4BxmHPhO hDbpuFMTRM9mvGrYG0gu+tvlOGHMIf3tngPa1Zslhg8Y3xgvSBiCgWeJR1sCokOi 6RVFMMayX+dLU9JEEl6+kIZ4ID+eIvNQErMu/4EfZKlN3S+Y8LroxzF8CZCqCc4= =0MR8 -----END PGP SIGNATURE-----

1 0

Fwd: [openstack-dev] [security] [docs] Security Guide Freeze and RST migration
by Andreas Jaeger 28 Jul '15

28 Jul '15

FYI, I suggest you stop translation and start once the RST conversion is done. Currently the RST files are not in transifex, I'll wait for the conversion to finish, Andreas -------- Forwarded Message -------- Subject: [openstack-dev] [security] [docs] Security Guide Freeze and RST migration Date: Tue, 21 Jul 2015 14:46:33 +0000 From: Dillon, Nathaniel <nathaniel.dillon(a)hp.com> Reply-To: OpenStack Development Mailing List (not for usage questions) <openstack-dev(a)lists.openstack.org> To: OpenStack Development Mailing List <openstack-dev(a)lists.openstack.org> All, The OpenStack Security Guide is migrating to RST format [1] and with help from the docs team we hope to have this completed shortly. We will therefore be entering a freeze on all changes coming into the Security Guide until the migration is complete, and all future changes will be in the much easier RST format. Progress can be tracked on the etherpad [2] or specific issues can be asked in reply to this message or during the Security Guide weekly meeting [3], and an announcement will be made when the migration is complete. Thanks, Nathaniel [1] https://bugs.launchpad.net/openstack-manuals/+bug/1463111 [2] https://etherpad.openstack.org/p/sec-guide-rst [3] https://wiki.openstack.org/wiki/Documentation/SecurityGuide __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev -- Andreas Jaeger aj(a){suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

1 1