Jump to: navigation, search

Difference between revisions of "Meetings/DocTeamMeeting"

(Weekly Documentation team meeting)
 
(101 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
{{OpenStack_Documentation_Navbar}}
 
{{OpenStack_Documentation_Navbar}}
  
= Weekly Documentation team meeting =
+
= Docs team meetings =
If you're interested in documentation for OpenStack, we hold public meetings weekly  in <code><nowiki>#openstack-meeting</nowiki></code> every Wednesday at alternating times for different timezones:
 
  
'''APAC''': even weeks Wednesday, 00:30:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+AU+Docs+Meeting&iso=20151201T00&p1=1440&ah=1
+
Provided there is an agenda to discuss, we hold docs team meetings every week.  
  
'''US''': odd weeks Wednesday, 14:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+US+Docs+Meeting&iso=20151201T14&p1=1440&ah=1
+
On even weeks on Thursday at 0730 UTC in <code><nowiki>#openstack-meeting</nowiki></code>.
 +
On odd weeks on Thursday at 1630 UTC in <code><nowiki>#openstack-meeting</nowiki></code>.
  
[http://eavesdrop.openstack.org/calendars/doc-team-meeting.ics Download an ICS file] for this specific meeting so you can import it into the calendar of your choice.
+
These IRC meetings are used to discuss general docs-related agenda. If you're looking to get started with documentation, or need to discuss work on a particular document, this is the place to do that.
Chair (to contact for more information): Lana Brindley (loquacities) and Shilla Saebi (shilla)
 
Please feel free to add items to the agenda below and we'll cover them.
 
  
== Agenda for next meeting ==
+
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 <code><nowiki>#openstack-doc</nowiki></code> at any time. You can also open discussions by emailing the <code><nowiki>openstack-discuss@lists.openstack.org</nowiki></code> mailing list and using the [docs] tag in subject.
  
When starting the meeting, use #startmeeting docteam to provide consistency.
+
== Agenda for the next meting ==
  
* Action items from the last meeting
+
Please tell us about your agenda items at the start of office hours.
* Specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z
 
** https://review.openstack.org/262219 (Common config-ref options)
 
* Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
 
** #info HA Guide - Open review: https://review.openstack.org/#/c/235893/
 
** #info Install Guides - Business as usual. Nothing special to mention this week.
 
** #info Networking Guide - Open reviews: https://review.openstack.org/#/c/239361/ Very slow progress, hoping to speed up after the USA holidays.
 
** #info Security Guide - no update.
 
** #info User Guides - After a specification update, there is a need to provide a more comprehensive scope: a list of Core features within scope, and include research on the nova-network/ neutron migration study. Contact from Zaqar, Trove, and Murano Liaisons on Admin guide tasks has been helpful, and given the reorganisation direction. A patch on fernet tokens (FAQ format) merged into the Cloud Admin Guide this week.
 
** #info Ops/Arch Guides - Arch guide migration is close to completion. We are currently planning to reorganize the guide over a two day virtual sprint in mid December.
 
** #info API docs - Cross project meeting held this week to talk about current state of API docs, tooling, and the vision for application developer guides. #link http://eavesdrop.openstack.org/meetings/crossproject/2016/crossproject.2016-01-12-21.02.log.html
 
** #info Config Ref - The tools are ready, the liberty branch is set up, the RST migration is on! Pick your file, run the tools, and let's review.
 
** #info OpenStack Training Labs - Training-labs has Kilo patch merged! We are currently updating the network configuration and trying to get things as per Matt's feedback/request. We plan to start adding Liberty very soon and also KVM port is on the way.
 
** #info OpenStack Training Guides - There is interest in translating Upstream training; we are waiting for https://review.openstack.org/#/c/245615/ to merge to enable it on the repo.
 
** #info Hyperviser Tuning Guide - On schedule - working on changing bullet-point notes into rough draft sections.
 
* Countdown to release
 
** #info DocImpact merged; however, more discussion about reno and how to triage doc bugs ensues
 
* Spotlight bugs
 
** Rewards scheme for killing old bugs
 
* Open discussion
 
  
== Apologies for absence ==
+
== Previous meetings ==
Add name here if you can't make it.
 
  
== Previous meetings ==
+
Previous meetings, with their notes and logs, can be found here: http://eavesdrop.openstack.org/meetings/docteam/
Previous meetings, with their notes and logs, can be found in under [[Documentation/MeetingLogs]]
+
 
 +
== Running IRC meetings ==
  
== Running Meetings ==
 
 
Public meetings are run in IRC; we use MeetBot syntax to note what happens during the meeting.
 
Public meetings are run in IRC; we use MeetBot syntax to note what happens during the meeting.
 
http://meetbot.debian.net/Manual.html
 
http://meetbot.debian.net/Manual.html
 +
 +
When starting the meeting, use <code><nowiki>#startmeeting docteam</nowiki></code> to provide consistency.
  
 
Useː
 
Useː
Line 51: Line 31:
 
* #topic <item>, for each agenda item that is being addressed
 
* #topic <item>, for each agenda item that is being addressed
 
* #link <url>, for relevant meeting URLs
 
* #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
 
* #action <item>, to note tasks for a specific person
 
* #endmeeting
 
* #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.
 
  
 
----
 
----
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 18:11, 12 December 2018

Docs team meetings

Provided there is an agenda to discuss, we hold docs team meetings every week.

On even weeks on Thursday at 0730 UTC in #openstack-meeting. On odd weeks on Thursday at 1630 UTC in #openstack-meeting.

These IRC meetings are used to discuss general docs-related agenda. If you're looking to get started with documentation, or need to discuss work on a particular document, this is the place to do that.

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-discuss@lists.openstack.org mailing list and using the [docs] tag in subject.

Agenda for the next meting

Please tell us about your agenda items at the start of office hours.

Previous meetings

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

Running IRC meetings

Public meetings are run in IRC; we use MeetBot syntax to note what happens during the meeting. http://meetbot.debian.net/Manual.html

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

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