Jump to: navigation, search

Difference between revisions of "Meetings/DocTeamMeeting"

(Agenda for next meeting)
 
(112 intermediate revisions by 8 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''': Wednesday, 00:30:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+AU+Docs+Meeting&iso=20150722T00&p1=1440&ah=1
+
Provided there is an agenda to discuss, we hold docs team meetings every week.  
  
'''US''': Wednesday, 14:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> http://www.timeanddate.com/worldclock/fixedtime.html?msg=OpenStack+US+Docs+Meeting&iso=20150715T14&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>.
  
Please feel free to add items to the agenda below and we'll cover them.
+
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.
  
== 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/#/c/217711/ (Liberty - Training Labs - naming now sorted out)
 
** https://review.openstack.org/#/c/227636/ (Mitaka - Ops Guide RST conversion)
 
** https://review.openstack.org/#/c/227660/ (Mitaka - Ops Guide reorg)
 
** https://review.openstack.org/#/c/224420/ (Mitaka - DocImpact)
 
* Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams
 
** #info HA Guide - Reviewing content. Any help appreciated.
 
** #info Install Guides - Need help testing against Liberty as packages are released: https://wiki.openstack.org/wiki/Documentation/LibertyDocTesting
 
** #info Networking Guide - Test & review for Liberty updates.
 
** #info Security Guide - RST conversion complete, and live.
 
** #info User Guides - Cloud Admin Guide reorg - big moves held over to Mitaka
 
** #info Ops/Arch Guides - Please review Mitaka specs.
 
** #info API docs - See status update #link http://lists.openstack.org/pipermail/openstack-docs/2015-September/007487.html
 
** #info Config Ref - Need help testing against Liberty as packages are released: https://wiki.openstack.org/wiki/Documentation/LibertyDocTesting
 
** #info OpenStack Training Labs - Contact Pranav Salunke #link https://wiki.openstack.org/wiki/Documentation/openstack-labs
 
* Countdown to Liberty
 
** #info Only 14 Days! #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand
 
** #info We have closed 553 bugs so far for this release
 
** #info Release notes: #link https://wiki.openstack.org/wiki/ReleaseNotes/Liberty
 
** #info Waiting on Install Guide testing to be further along before we branch
 
* Mitaka Design Summit
 
** #info I will remain as PTL for Mitaka
 
** #info We have session allocations for docs now. Add your suggestions here: https://etherpad.openstack.org/p/Tokyo-DocsSessions
 
* Spotlight bugs:
 
** During Liberty we spotlighted a total of 24 bugs, exactly half of which have now been closed. Thanks go out to Tom Fifield, Olga Gusarenko, Yusuke Ide, Brian Moss, Deena Cooper, and Alexandra Settle.
 
* #topic If it's not triaged, don't fix it!
 
* Please remember to have your bugs independently verified before you start work on them. On the flipside: please remember to triage bugs as often as you can, to keep the wait times down.
 
* 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 58: 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