This is where I draft the 'What's Up, Doc?' documentation newsletters. The newsletter is distributed every Friday (ish), to the openstack-docs mailing list. If you want to be added to the distribution list, or have content to add, please edit these sections:
- OpenStack Docs Mailing List <Openstackfirstname.lastname@example.org>
- OpenStack Development Mailing List <email@example.com>
- Docs liaisons (from https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation)
- i18n List <firstname.lastname@example.org>
Speciality team reports are gathered here: https://etherpad.openstack.org/p/Speciality_Team_Reports
- New openstackdoocstheme release - 1.5.0
Looking for older editions?
You can see older newsletters here: Documentation/WhatsUpDoc_Archive
2 September 2016
This week marks six weeks left to the Newton release, so I've been busy getting everything prepared. We're now ready to start testing the core Installation Tutorial, so check out the wiki and get signed up: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting#Testers We've also selected two new release managers to assist with this release, please welcome Olena and Alex! More on those topics in this newsletter.
Progress towards Newton
40 days to go!
Bugs closed so far: 387
Release planning: https://etherpad.openstack.org/p/NewtonRelease
There was an overwhelming response to my request for release managers, which was very cool! The first two responders were Olena Logvinova <email@example.com> and Alexandra Settle <alexandra.settle@RACKSPACE.COM>, so please welcome them to the release team. Their main role during this process is to make sure that all the tasks we have to complete get done accurately and on schedule. It's an important job, and we're really glad to have you both on board.
Install Tutorial Testing
Install Tutorial testing is just about ready to kick off. If you're interested in helping, make sure you've added your name on to the list on our testing wiki page: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting (if you don't have wiki access, just email me directly and I'll add you in).
Thanks to our package maintainers, we now have b2 pre-release packages ready for Ubuntu and Debian, so those are ready to be tested.
I'm very pleased to announce that we have now removed DocBook from our build tools. The end of an era! Thanks to Anne, Andreas, and David Cramer for keeping this project alive for so long, and eventually seeing it come to fruition.
Version 1.5.0 of openstackdoccstheme was released this week.
In other tools news, there are plans afoot to move developer.openstack.org and docs.openstack.org away from Rackspace Cloudsites, and on to pages that OpenStack Infra control. This has been on the proverbial backburner for a long time, but the Infra team is now in a position to make it happen. You can read and comment on the Infra spec here: https://review.openstack.org/#/c/276482/
Speciality Team Reports
HA Guide: Andrew Beekhof No report this week.
Install Tutorials: Lana Brindley Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 30 August 0600UTC.
Networking Guide: Edgar Magana Attending the OpenStack East in NYC. No report this week.
Security Guide: Nathaniel Dillon No report this week.
User Guides: Joseph Robinson No report this week.
Ops Guide: Shilla Saebi, Darren Chan No report this week.
API Guide: Anne Gentle Releasing openstackdocstheme with new sidebar and integration with os-api-ref Sphinx Extension. Many thanks to Karen Bradshaw, Sean Dague, Graham Hayes, Andreas Jaeger (and anyone I may have missed!) for their tireless efforts on this release. WOW.
Config/CLI Ref: Tomoyuki Kato Merged some patches, updated a few CLI reference, nothing special.
Training labs: Pranav Salunke, Roger Luethi Some minor changes, backports of features. The parser is almost done. https://github.com/dguitarbite/rst2bash Updated the openstack-manuals, install-guides with the new syntax which is parser friendly. I should start sending the required patches to manuals repo. soon after finalizing the syntax.. https://github.com/dguitarbite/openstack-manuals/commit/c9e7e1bb2c7269f02a757768dd2dd309fa2233ac
Training Guides: Matjaz Pancur Upstream training improvement (https://etherpad.openstack.org/p/upstream-university-improvements). Please consider participating in the Remote content sprint (proposed timeframe: first half of September, see etherpad for details).
Hypervisor Tuning Guide: Blair Bethwaite No report this week.
UX/UI Guidelines: Michael Tullis, Rodrigo Caballero No report this week.
Keystone and Ceph are this week's most popular search terms.
Doc team meeting
The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-08-24
Next meetings: US: Wednesday 31 August, 19:00 UTC APAC: Wednesday 7 September, 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_meeting
Keep on doc'ing!