Revision as of 04:04, 6 November 2015

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
• https://wiki.openstack.org/wiki/Successes

Looking for older editions?

You can see older newsletters here: Documentation/WhatsUpDoc_Archive

6 November 2015

Hi everyone,

Wow! What a great Summit! And isn't Tokyo a truly beautiful and amazing city? Thank you so much to the Japanese Stackers who hosted us, and to everyone who came along to the docs sessions and helped us hammer out a great plan for Mitaka. I'm very excited about this release!

This week, I've been catching up with everything that happened during Summit, and also working on outreach tasks. Today, I recorded an interview with Foundation about the project, and I've also published a blog post on the same topic, which will be published soon. You might also like to check out the SuperUser interview Anne and I did about the docs while we were in Tokyo: http://superuser.openstack.org/articles/openstack-documentation-why-it-s-important-and-how-you-can-contribute

Progress towards Mitaka

152 days to go!

77 bugs closed so far for this release.

API Docs

• The API docs are will be switched to swagger: http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html

DocImpact

• I've removed the WIP from this blueprint, and will be working on this from next week: https://blueprints.launchpad.net/openstack-manuals/+spec/review-docimpact

RST Conversions

• Arch Guide
  • https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-rst
  • Contact the Ops Guide Speciality team: https://wiki.openstack.org/wiki/Documentation/OpsGuide
• Ops Guide
  • https://blueprints.launchpad.net/openstack-manuals/+spec/ops-guide-rst
  • Lana will reach out to O'Reilly to discuss the printed book before this work begins
• Config Ref
  • Thanks for all the offers of help on this one! Please contact the Config Ref Speciality team: https://wiki.openstack.org/wiki/Documentation/ConfigRef

Reorganisations

• Arch Guide
  • https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-reorg
  • Contact the Ops Guide Speciality team: https://wiki.openstack.org/wiki/Documentation/OpsGuide
• User Guides
  • https://blueprints.launchpad.net/openstack-manuals/+spec/user-guides-reorganised
  • Contact the User Guide Speciality team: https://wiki.openstack.org/wiki/User_Guides

Training

• Labs
  • https://blueprints.launchpad.net/openstack-manuals/+spec/training-labs
• Guides
  • Upstream University & 'core' component updates, EOL Upstream Wiki page.

Document openstack-doc-tools

• Need volunteers for this!

Doc team meeting

The US meeting was held this week. The minutes are here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2015-10-07

The next meetings will be the final meetings before the Liberty release: APAC: Wednesday 14 October, 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_meeting

--

東京でお会いしましょう (See you in Tokyo!)

Lana