Revision as of 00:15, 30 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

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/217711/ (Liberty - Training Labs - naming now sorted out)
  • 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 - Reviewing content. Any help appreciated.
  • #info Install Guides - Need help testing against Liberty as packages are released.
  • #info Networking Guide - Test & review for Liberty updates.
  • #info Security Guide - RST conversion complete, and live.
  • #info User Guides - Cloud Admin Guide reorganisation underway.
  • #info Ops/Arch Guides - Prepping for RST conversion in Mitaka. Please let Shilla or Darren know if you want to be involved in this team.
  • #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 #link https://wiki.openstack.org/wiki/Documentation/openstack-labs
• Countdown to Liberty
  • #info 29 Days! #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand
  • #info Release notes: #link https://wiki.openstack.org/wiki/ReleaseNotes/Liberty
• Mitaka Design Summit
  • #info Mitaka PTL elections next week #link https://wiki.openstack.org/wiki/PTL_Elections_September_2015
  • #info We have session allocations for docs now. I'll be asking you for your suggestions in the next week or so.
• Spotlight bugs:
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1284301 Document Neutron SSL-VPN for cloudadmin
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1288044 Add user defined extra capabilities
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1292327 Make cors work better
• 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.