Revision as of 23:15, 15 September 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

Scheduled for Wednesday Sep 2, 2015, 0030 UTC in #openstack-meeting.

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

• Action items from the last meeting
• Liberty specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z
  • #link https://review.openstack.org/#/c/191041/ (Third Party driver docs - please read, will be approved shortly)
  • #link https://review.openstack.org/#/c/219936/ (Fixing up an existing spec - needs a core to merge)
• Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
  • #info HA Guide - Reviewing content. Any help appreciated.
  • #info Install Guides - RST migration complete, need help testing RST against Kilo.
  • #info Networking Guide - Test & review for Liberty updates.
  • #info Security Guide - RST conversion complete, and live.
  • #info User Guides - Cloud Admin Guide RST migration complete, work starting on reorganisation.
  • #info Ops/Arch Guides - Blueprints merged for reorg of the Arch Guide in Mitaka. Upgrade documentation to be completed for Liberty.
  • #info API docs - See status update #link http://lists.openstack.org/pipermail/openstack-dev/2015-August/072557.html
  • #info Config Ref - Contact Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef
  • #info OpenStack Labs - Contact Pranav Salunke
• Countdown to Liberty
  • #info 42 Days! #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand
  • Visa requirements for Tokyo
  • ATC passes
• Spotlight bugs:
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1257018 VPNaaS isn't documented in cloud admin
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1257656 VMware: add support for VM diagnostics
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1261969 Document nova server package
• 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.