Jump to: navigation, search

Difference between revisions of "Meetings/DocTeamMeeting"

(Agenda for next meeting)
(Agenda for next meeting)
Line 21: Line 21:
 
* Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
 
* Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
 
** #info HA Guide - RST migration complete, need help with updating content.
 
** #info HA Guide - RST migration complete, need help with updating content.
** #info Install Guides - RST migration nearly complete, testing to begin shortly.
+
** #info Install Guides - RST migration complete, testing for Liberty starting soon.
** #info Networking Guide - Test & review for Liberty updates. Need to audit content in devref.
+
** #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 Security Guide - RST conversion complete, and live.
** #info User Guides - Cloud Admin Guide RST migration complete, need to start work on reorganisation.
+
** #info User Guides - Cloud Admin Guide RST migration complete, work starting on reorganisation.
** #info Ops/Arch Guides - Arch Guide swarm coming up. #link https://wiki.openstack.org/wiki/Documentation/OpsGuide
+
** #info Ops/Arch Guides - Arch Guide swarm was a success. Plans for reorganisation in Mitaka.
** #info API docs - Spec is now merged! #link https://wiki.openstack.org/wiki/Documentation/API
+
** #info API docs - New API tool afoot. Python devs required! Contact Anne.
** #info Config Ref - New speciality team! Thanks Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef
+
** #info Config Ref - Contact Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef
* Doc tools update:
+
** #info Training Labs - Contact Pranav Salunke
** #info we released openstackdocstheme 1.2.0 and it includes the dynamic TOC and next/previous/report a bug links at the bottom of pages
 
* Licencing
 
** #info Lana and Anne are consulting with legal on this
 
 
* APAC Meetups
 
* APAC Meetups
** Reminder: APAC Docs Swarm on 13-14 August, ping Suyog
+
** Thanks to Suyog for organising the swarm, and to all contributors and reviewers.
 
* Spotlight bugs:
 
* 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/1257018 VPNaaS isn't documented in cloud admin

Revision as of 23:37, 18 August 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 Aug 19, 2015, 0030 UTC in #openstack-meeting.

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

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.