Revision as of 15:45, 1 November 2017

Documentation team meeting

Every two weeks (on even weeks) on Wednesday at 1600 UTC in #openstack-doc.

This meeting is used to discuss the status of the docs team and general docs updates. If you're looking to get started with documentation, or need to discuss work on a particular book, this is the place to do that.

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.

• #topic Docs team vision document
  • #info At final review
  • #link https://review.openstack.org/#/c/514779/
  • #info Sent a reminder asking for more input
  • #info Let's close by Thu, before the Summit

• #topic Docs retention policy changes
  • #info We've just approved this spec. Thanks Doug for putting this together!
  • #link https://review.openstack.org/#/c/507629
  • #info Flagging deprecated releases
  • #link http://lists.openstack.org/pipermail/openstack-dev/2017-October/123381.html

• #topic Branches vs everything in master
  • Common Install Guide content should be branched/split up per-release?

• #topic OpenStack Summit Sydney
  • #info Quite a few docs-related sessions scheduled
  • #info Installation Guides and Tutorials Updates and Testing
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20448/installation-guides-and-tutorials-updates-and-testing
  • #info Docs - Project Update
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20373/docs-project-update
  • #info Docs/i18n - Project Onboarding
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20550/docsi18n-project-onboarding
  • #info Ops Guide Transition and Maintenance
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20446/ops-guide-transition-and-maintenance
  • #info Documentation and relnotes, what do you miss?
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20468/documentation-and-relnotes-what-do-you-miss
  • #info How Zanata powers upstream collaboration with OpenStack internationalization
  • #link https://www.openstack.org/summit/sydney-2017/summit-schedule/events/20007/how-zanata-powers-upstream-collaboration-with-openstack-internationalization

• #topic sitemap automation suggestions
  • #link http://lists.openstack.org/pipermail/openstack-dev/2017-October/123228.html

• #topic Bug Triage Team
  • #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams

• #topic PDF builds
  • #link https://review.openstack.org/#/c/509297/

• #topic Open discussion

Apologies for absence

Previous meetings

Previous meetings, with their notes and logs, can be found here: http://eavesdrop.openstack.org/meetings/docteam/

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
• #info <info> for important notes that need to be added to the minutes
• #action <item>, to note tasks for a specific person
• #endmeeting

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.