Jump to: navigation, search

Difference between revisions of "Meetings/DocTeamMeeting"

(Apologies for absence)
(Apologies for absence)
Line 43: Line 43:
 
== Apologies for absence ==
 
== Apologies for absence ==
  
* Kato. CLI Ref report:  
+
* John. Networking Guide:
  
CLI Reference:
+
Not much from the networking guide this week. A couple more patches in
We try to recreating the single page view for the "openstack" command.
+
flight to address the OSC transition. This one looks good to me:
I'd like to generate the reference from source code automatically.
 
However, python-openstackclient has many plug-ins.
 
It is difficulty, but worth to tackle it. We need your help!
 
  
* Anne. API report:
+
https://review.openstack.org/#/c/410550/
  
The App Dev Support WG is working on a survey to determine which content areas to invest in for content on http://www.openstack.org/appdev. (http://lists.openstack.org/pipermail/user-committee/2016-November/001469.html)
+
Haven’t looked at Ankur’s other patch yet but will get to it soon.
 
 
* Matjaz. Training Guides reports:
 
 
 
- BCN Upstream training article in the Superuser magazine: http://superuser.openstack.org/articles/openstack-upstream-training-revamp/
 
- actively looking for contributors to join the Upstream training, please see http://lists.openstack.org/pipermail/openstack-docs/2016-November/009382.html
 
- cleaned test entries in the Launchpad bug queue and the Sandbox repository (left from the Barcelona Upstream training)
 
- updated Training guides’ README.rst
 
  
 
== Previous meetings ==
 
== Previous meetings ==

Revision as of 20:46, 15 December 2016

Documentation team meeting

Every two weeks (on even weeks) on Thursday at 2100 UTC in #openstack-meeting-alt http://www.timeanddate.com/worldclock/fixedtime.html?msg=Documentation+Team+Meeting&iso=20161117T21&p1=1440&ah=1

This meeting is used to discuss the status of the various docs speciality teams, as well as 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.

Apologies for absence

  • John. Networking Guide:

Not much from the networking guide this week. A couple more patches in flight to address the OSC transition. This one looks good to me:

https://review.openstack.org/#/c/410550/

Haven’t looked at Ankur’s other patch yet but will get to it soon.

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

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.