Revision as of 05:45, 6 May 2016

Documentation Newsletters

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:

Distribution List

• OpenStack Docs Mailing List <Openstack-docs@lists.openstack.org>
• OpenStack Development Mailing List <openstack-dev@lists.openstack.org>
• Docs liaisons (from https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation)
• i18n List <openstack-i18n@lists.openstack.org>

Your suggestions for content

• Your
• Content
• Here
• The operations-guide repository is now frozen. The content is converted to RST and now part of the openstack-manuals repository. Last cleanup edits are ongoing before the RST version gets published.
• The api reference content is moving from api-site to project specific repositories and is now (double check!) frozen. Documentation on how to migrate is available at XXX.
• The docs toolchain is removing DocBook XML support, see spec https://review.openstack.org/311698 for details.
• Mobile apps are now available. Don’t delay - download and build your personal schedule now for the best performance! iOS / Apple: https://itunes.apple.com/us/app/openstack-foundation-summit/id1071261846?mt=8 and Google Play / Android: https://play.google.com/store/apps/details?id=org.openstack.android.summit

Looking for older editions?

You can see older newsletters here: Documentation/WhatsUpDoc_Archive

6 May 2016

Hi everyone,

I hope everyone had a safe journey home from Summit, and is 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

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!

152 days to go!

Bugs closed so far: 61

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

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-03-30

Next meetings: APAC: No APAC meeting this week US: Wednesday 13 April, 19:00 UTC (This is after the Mitaka release)

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!

Lana

https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#6_May_2016