Jump to: navigation, search

Difference between revisions of "Meetings/DocTeamMeeting"

(Agenda for next meeting)
 
(174 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
{{OpenStack_Documentation_Navbar}}
 
{{OpenStack_Documentation_Navbar}}
  
= Weekly/Fortnightly  doc/web team meeting =
+
= Docs team meetings =
If you're interested in documentation and the web content for OpenStack, we hold public meetings weekly  in <code><nowiki>#openstack-meeting</nowiki></code> every Wednesday at alternating times for different timezones:
 
  
* 1st Wednesday, 01:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> (APAC)
+
Provided there is an agenda to discuss, we hold docs team meetings every week.
* 2nd Wednesday, 14:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> (US)
 
* 3rd Wednesday, 01:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> (APAC)
 
* 4th Wednesday, 14:00:00 UTC <code><nowiki>#openstack-meeting</nowiki></code> (US)
 
  
Please feel free to add items to the agenda below and we'll cover them.
+
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>.
  
== Agenda for next 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.
Scheduled for Wednesday April 22, 2015, 1400 UTC in #openstack-meeting.
 
  
When starting the meeting, use #startmeeting docteam to provide consistency.
+
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.
  
* Action items from the last meeting
+
== Agenda for the next meting ==
* PTL changes: Anne will complete Kilo, Lana is planning Liberty
 
* Kilo tasks:
 
** RST publishing - i18n
 
** Bug triaging
 
** Networking Guide doc day  23 April
 
* Docs specs in review
 
** #link https://review.openstack.org/174647 (Work in progress user guides)
 
** Training team specs
 
* Next migration project
 
** #link https://docs.google.com/spreadsheets/d/10HD6iW1CtfB1qT2wVODYiHdC0ysr4xw392VCqHB-aaY/edit?usp=sharing
 
* Specialty teams
 
** HA Guide - Needs an updated spec
 
** Training Guides
 
** Install Guides - RST conversion convo
 
** User Guides - IA of guides
 
** Security Guide
 
** API docs
 
** Networking Guide - Test & review
 
* Doc tools update: use 2.1.4 clouddocs-maven-plugin for Kilo
 
* Vancouver
 
** Design summit sessions etherpad here: #link https://etherpad.openstack.org/p/Docs_Liberty_Design_Sessions
 
*APAC Meetups
 
** Planning for an APAC OpenStack meet up in May, ping asettle
 
** Planning for APAC Docs Swarm on 17-18 August
 
* Open discussion
 
  
== Apologies for absence ==
+
Please tell us about your agenda items at the start of office hours.
Add name here if you can't make it.
 
  
 
== Previous meetings ==
 
== Previous meetings ==
Previous meetings, with their notes and logs, can be found in under [[Documentation/MeetingLogs]]
 
  
== Running 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.
 
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 57: 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).
 
 
== 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.
 
  
 
----
 
----
 
[[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