Revision as of 00:32, 14 October 2015

Weekly Documentation team meeting

If you're interested in documentation for OpenStack, we hold public meetings weekly in #openstack-meeting every Wednesday at alternating times for different timezones:

APAC: Wednesday, 00:30:00 UTC #openstack-meeting http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+AU+Docs+Meeting&iso=20150722T00&p1=1440&ah=1

US: Wednesday, 14:00:00 UTC #openstack-meeting http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+US+Docs+Meeting&iso=20150715T14&p1=1440&ah=1

Please feel free to add items to the agenda below and we'll cover them.

Agenda for next meeting

When starting the meeting, use #startmeeting docteam to provide consistency.

• Action items from the last meeting
• Specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z
  • https://review.openstack.org/#/c/227636/ (Mitaka - Ops Guide RST conversion)
  • https://review.openstack.org/#/c/227660/ (Mitaka - Ops Guide reorg)
  • https://review.openstack.org/#/c/224420/ (Mitaka - DocImpact)
• Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
  • #info HA Guide - RST version (with a draft warning) to be published with Liberty. New speciality team forming under Bogdan Dobrelya for Mitaka.
  • #info Install Guides - Final stages of testing as we get ready to publish (with a pre-release warning). Debian delisted for now.
  • #info Networking Guide - New speciality team forming under Edgar Magana for Mitaka.
  • #info Security Guide - no update.
  • #info User Guides - Cloud Admin Guide reorg - big moves held over to Mitaka
  • #info Ops/Arch Guides - Please review Mitaka specs.
  • #info API docs - See status update #link http://lists.openstack.org/pipermail/openstack-docs/2015-September/007487.html
  • #info Config Ref - Scripts to be run today and tomorrow to pick up any final changes for Liberty.
  • #info OpenStack Training Labs - Contact Pranav Salunke #link https://wiki.openstack.org/wiki/Documentation/openstack-labs
• Countdown to Liberty
  • #info Only 23 hours! #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand
  • #info We have closed over 600 bugs for this release
  • #info Release notes are drafted and proofed. Thanks to Darren Chan, Joseph Robinson, and Alexandra Settle, as well as all the project PTLs: #link https://wiki.openstack.org/wiki/ReleaseNotes/Liberty
  • #info Release tasks are being tracked here: https://etherpad.openstack.org/p/Liberty_ReleaseTasks
  • #index.html went live for Liberty last night, on Thursday we will update the front page to redirect to the new Liberty books.
  • #info No non-critical changes are being accepted into the Install or Config Ref books now. Any patches will be -2d and asked to be held over until we branch.
• Mitaka Design Summit
  • #info We have a schedule: http://mitakadesignsummit.sched.org/type/Documentation
• Open discussion

Apologies for absence

Add name here if you can't make it.

Previous meetings

Previous meetings, with their notes and logs, can be found in under Documentation/MeetingLogs

Running Meetings

Public meetings are run in IRC; we use MeetBot syntax to note what happens during the meeting. http://meetbot.debian.net/Manual.html

Useː

• #startmeeting docteam
• #topic <item>, for each agenda item that is being addressed
• #link <url>, for relevant meeting URLs
• #action <item>, to note tasks for a specific person
• #endmeeting

After the meeting ends, edit the wiki page https://wiki.openstack.org/wiki/Documentation/MeetingLogs with links to the log and minutes (displayed in IRC at the end of each meeting).

Office hours

We no longer hold formal office hours, but if you would like to walk through documentation processes, learn about the tools, or report a doc bug, feel free to come by the IRC channel at #openstack-doc at any time. You can also open discussions by emailing the openstack-docs@lists.openstack.org mailing list.