Revision as of 23:03, 21 July 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 June 22, 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 - requires discussion)
  • #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update - WIP)
  • #link https://review.openstack.org/#/c/197976/ (Contributor/Style Guide)
• Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
  • #info HA Guide - RST migration complete, need help with updating content.
  • #info Install Guides - Conversion sprint this week! #link https://wiki.openstack.org/wiki/VirtualSprints#Installation_guide_conversion_from_DocBook_to_RST Sign up for conversion here #link https://wiki.openstack.org/wiki/Documentation/Migrate#Installation_Guide_Migration
  • #info Networking Guide - Test & review for Liberty updates.
  • #info Security Guide - RST conversion started, sign up here: #link https://etherpad.openstack.org/p/sec-guide-rst
  • #info User Guides - Cloud Admin Guide RST conversion nearly done! #link https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration
  • #info Ops/Arch Guides - Ops Guide conversion targeted for Mitaka. #link https://wiki.openstack.org/wiki/Documentation/OpsGuide
  • #info API docs - Spec is now merged! #link https://wiki.openstack.org/wiki/Documentation/API
  • #info Config Ref - New speciality team! Thanks Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef
• Doc tools update:
  • #info openstackdocstheme 1.1.0 released: Release notes: #link http://lists.openstack.org/pipermail/openstack-announce/2015-June/000392.html
  • Stable/Icehouse branch is now EOL
• APAC Meetups
  • Reminder: APAC Docs Swarm on 13-14 August, ping Suyog
• Spotlight bugs:
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1241116 Using policies for protected properties
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1241179 Add notifications for groups and roles
  • #link https://bugs.launchpad.net/openstack-manuals/+bug/1251060 Xenapi: Allow windows builds with xentools 6.1 and 6.2
• 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).

Google Hangout for Docs

Scheduled for Wednesday, March 26, 2014 at 21:00:00 UTC Look for Hangouts On Air invitation on Google Plus.

• Icehouse
  • Status of RC1 - refer to http://eavesdrop.openstack.org/meetings/project/2014/project.2014-03-25-21.01.log.html
  • Updates for Installation Guide - would like Object Storage architecture diagram, discussed heat and ceilometer arch, might mention MongoDB for ceilometer)
  • Appendix for Ops Guide with Icehouse preview - Anne writing this week and next
  • Configuration files with distros (default files can be lengthy but commented out so you can see the settings)
  • Deprecation messages for v2 Keystone API will be more muted

• Summit
  • Documentation track and presentations
  • Discussion of cross-project topics

• Anything else? Add here.

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.