Meetings/DocTeamMeeting
Contents
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
US: Wednesday, 13:00:00 UTC #openstack-meeting
Please feel free to add items to the agenda below and we'll cover them.
Agenda for next meeting
Scheduled for Wednesday June 10, 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/191074 (Debian Install Guide)
- #link https://review.openstack.org/#/c/191041/ (Driver docs - requires discussion)
- #link https://review.openstack.org/#/c/191520/ (Install Guide RST conversion)
- #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update)
- #link https://review.openstack.org/#/c/177934/ (API work)
- Specialty teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
- #info HA Guide - RST migration underway: #link https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide
- #info Install Guides - Specs now up for review #link https://review.openstack.org/#/c/191520/ (RST conversion) and #link https://review.openstack.org/#/c/191077/ (Liberty update)
- #info Networking Guide - Test & review. Blueprint/spec to be created for Liberty work.
- #info Security Guide - RST conversion in planning.
- #info User Guides - Cloud Admin Guide RST conversion now underway https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration
- #info Ops/Arch Guides - New speciality team! Thanks Shilla #link https://wiki.openstack.org/wiki/Documentation/OpsGuide
- #info API docs - Please review the spec #link https://review.openstack.org/#/c/177934/
- #info Config Ref - New speciality team! Thanks Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef
- Doc tools update: no news
- Docs Liaisons
- Don't forget our lovely liaisons: #link https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation
- APAC Meetups
- Planning for an APAC OpenStack meet up in June, ping asettle & adahms
- Planning for APAC Docs Swarm on 13-14 August, ping Suyog
- Ironic Docs
- Gauvain and Nick are going to be working on reviewing the Ironic Install Guide. If you want to help, please ping Lana.
- Spotlight bugs:
- https://bugs.launchpad.net/openstack-manuals/+bug/1195875 Controller Callbacks
- https://bugs.launchpad.net/openstack-manuals/+bug/1201978 Pluggable Remote User
- https://bugs.launchpad.net/openstack-manuals/+bug/1204566 Stop and delete operations
- 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.