Jump to: navigation, search

Difference between revisions of "User Guides"

(→‎Meetings)
(→‎Meetings)
 
(103 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
Welcome to the home page for the User Guide Specialty Team!
+
We are the User Guides Specialty team!  
  
 
== About the User Guide team ==
 
== About the User Guide team ==
  
−
This team is all about the users. Its purpose is to give us a space to have conversations about enterprise content, support companies who reuse upstream content from the guides, and also get some focus on information architecture, consistency, and conventions in the guides.
+
This team is all about the users. We support companies who reuse upstream content from the guides, and focus on information architecture, consistency, and conventions in the guides.
  
−
We focus on:
+
We maintain:
−
* Cloud Admin Guide (migrating to RST)
+
 
−
* End User Guide (migrating to RST)
+
* Openstack Admin Guide
−
* Admin User Guide (migrating to RST)
+
* End User Guide
  
 
For the Install Guide and the Networking Guide, see those respective speciality groups.
 
For the Install Guide and the Networking Guide, see those respective speciality groups.
  
 
== Quick links ==
 
== Quick links ==
 +
 +
*User Guide Team Meeting information [https://wiki.openstack.org/wiki/Meetings/DocUserGuidesTeamMeeting Meeting Instructions and Agenda]
 +
*Task List [https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides User Guide Task List].
 +
*Blueprint for editing the User Guides [https://blueprints.launchpad.net/openstack-manuals/+spec/user-guide-editing]
 +
*(Previous Tasks)Blueprint for reference and implementation [https://blueprints.launchpad.net/openstack-manuals/+spec/user-guides-reorganised Blueprints]
 +
 +
== Team members ==
 +
 +
* Joseph Robinson, Team Lead, Rackspace, Brisbane Australia (UTC+10)
 +
* Gudrun Wolfgram, IBM, US.
 +
* Linette Williams,  IBM, US.
 +
* Bernd Bausch, Japan. Not quite certain yet to what extent I can contribute.
 +
* Tanja Roth, SUSE, Germany (UTC+1)
 +
* Emett Speer, Vancouver, Canada (UTC+8)
 +
* Alexandra Settle, Rackspace, London, United Kingdom (UTC)
 +
* Brian Moss, Rackspace, Brisbane Australia (UTC+10)
 +
* Darren Chan, Rackspace, Canberra Australia (UTC+10)
 +
* Deepti Navale, Red Hat, Sydney Australia (UTC+10)
  
 
== Housekeeping ==
 
== Housekeeping ==
Line 18: Line 36:
 
* Use '''[User Guides]''' in the subject line of emails to the openstack-doc mailing list.
 
* Use '''[User Guides]''' in the subject line of emails to the openstack-doc mailing list.
 
* Keep track of tasks with the [https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides User Guide Task List].
 
* Keep track of tasks with the [https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides User Guide Task List].
−
* Blueprints [https://blueprints.launchpad.net/openstack-manuals/+spec/reorganise-user-guides User Guide Blueprints].
+
* First Blueprint (complete) [https://blueprints.launchpad.net/openstack-manuals/+spec/reorganise-user-guides User Guide Blueprints].
 +
* Second Blueprint (ongoing) [https://blueprints.launchpad.net/openstack-manuals/+spec/user-guides-reorganised M User Guide Blueprints].
  
 
== Meetings ==
 
== Meetings ==
  
−
Meetings are held on fortnightly on Wednesdays at 23:30 UTC (Thursday 9:30am Australian Eastern Standard Time or GMT+10, Wednesday 4:30pm Pacific Standard Time), on Google Hangouts. If you're not on the google calendar invitation list and want to be, please make yourself known to Joseph or Brian through IRC or the Openstack-Doc mailing list. 
+
'''The User Guide Specialty Team Meetings previously ran monthly on IRC. Currently, these meetings are suspended, with the options of using the time for User Guide discussion if needed. User Guides are regularly discussed in the [https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting OpenStack Docs Meeting]'''
 +
 
 +
We hold one monthly meeting on the ''#openstack-meeting-4'' IRC channel:
 +
 
 +
* '''Doc User Guides Meeting''' on Wednesdays at [06:30 AM UTC http://www.timeanddate.com/worldclock/fixedtime.html?msg=User+Guide+Specialty+Team+Meeting&iso=20161208T1630&p1=47 ] (Thursday 4:30pm Australian Eastern Standard Time or GMT+10, Wednesday 4:30pm Pacific Standard Time)
 +
 
  
−
=== Action Items ===
+
We have a page with instructions on running meetings with MeetBot, which is the same tracker used in the Weekly OpenStack Docs meetings - [https://wiki.openstack.org/wiki/Meetings/DocUserGuidesTeamMeeting Meeting Instructions and Agenda]
−
*Thursday 06/25/15
 
−
**Update Calendars and Meeting times for the next meetings - change to fortnight - Joe
 
  
−
*Thursday 06/18/15
+
Get an ical file here: http://eavesdrop.openstack.org/#Documentation_User_Guides_Team_Meeting
−
*Thursday 06/11/15
 
−
**Updated Documentation/Migrate wiki table for Cloud Admin Guide with Networking.xml conversion chapters marked as "On Hold" - Alex - DONE
 
  
−
*Thursday 06/04/15
+
Previous meetings took place on Google Hangouts  - Meeting link: [https://plus.google.com/hangouts/_/calendar/OHEzajk1ZjB2djRmZW9tMnB1cjNsdGRrMWtAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ.8amajg4mrflp20h0fi0ij7mlmo User Guide Team Hangout]
−
**Email out request for Cloud Admin Guide repository freeze. - Brian, Joe. - DONE
 
−
**Linking RST conversion to the User Guide improvement blueprints - Brian - DONE
 
−
**Move HOT guide from heat repository - Brian (https://bugs.launchpad.net/openstack-manuals/+bug/1461720)
 
−
**HowTo overhaul discussion, and HowTo for first timers. Brian
 
  
 
=== Agenda for next meeting ===
 
=== Agenda for next meeting ===
−
*Thursday 06/25/15
+
The meeting agenda page - [https://wiki.openstack.org/wiki/Meetings/DocUserGuidesTeamMeeting Meeting Instructions and Agenda]
−
**RST check in: any questions or discussions?
+
 
−
**Any returning members need an update?
+
===MeetingLogs===
−
**Any bugs for cloud admin to tag, pause, or merge?
+
Meeting 09/11/16
 +
 
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.log.html
 +
 
 +
 
 +
Meeting 02/11/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-02-21.01.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-02-21.01.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-02-21.01.log.html
 +
 
 +
APAC Meeting
 +
*
 +
 
 +
Meeting 21/09/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-09-21-21.03.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-09-21-21.03.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-09-21-21.03.log.html
 +
 
 +
APAC Meeting
 +
*
 +
Meeting 21/07/16
 +
US Meeting
 +
*Minutes: http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-20-21.19.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-20-21.19.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-20-21.19.log.html
 +
 
 +
APAC Meeting
 +
*No Meeting this fortnight
 +
 
 +
Meeting 07/07/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-06-21.01.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-06-21.01.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-06-21.01.log.html
  
−
*Thursday 06/18/15
+
APAC Meeting
−
**Action items from last meeting - networking sections tagged
+
* No meeting this fortnight
−
**Networking sections updates
 
−
**Any past items to discuss
 
  
−
*Thursday 06/11/15
+
Meeting 15/06/16
−
**Action items from last meeting - All either Done or Doing.
+
US Meeting
−
**Cloud Admin Guide RST Conversion - Hold off on converting networking sections, as these may be removed entirely
+
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.html
−
** :option: tagging note - :orphan: directive for common files
+
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.txt
−
**Any past items to discuss.
+
*Log:           http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.log.html
  
−
*Thursday 06/04/15
+
APAC Meeting
−
**Cloud Admin Guide RST Conversion
+
* No meeting this fortnight
−
**Cloud Admin Guide bugs: This one https://review.openstack.org/#/c/187339/5
 
−
*IA Update post conference.
 
  
−
*Thursday 05/28/15
+
Meeting 02/06/16
−
**The Cloud Admin Guide RST Conversion is now a priority follow the summit. So this crosses off a question from
+
US Meeting
−
two weeks ago on whether the guide was in our scope. There is a task tracking table added to the RST migration page on the Wiki.
+
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.html
−
**There is now a new heading on the RST conversion task tracking page.
+
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.txt
−
**Question for experienced writers - Where to start from here?
+
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.log.html
−
*IA Update:
 
−
** Rename the Virtual Machine Image Guide to the Cloud Image Guide
 
−
** Admin Guide versioning. One consideration is to add versioning to the Admin Guide
 
−
** Move Hot Guide from End User Guide to Heat repo
 
−
**Rewriting the How-To section, resulting in doc that has ease of readability. This must avoid duplication of the infra-manual.
 
  
−
* Thursday 05/14/15
+
APAC Meeting
−
** Will the scope include Cloud Admin Guide alongside the User and Admin Guides?
+
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.html
−
** The tasks tracking page is now active: https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides
+
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.txt
−
** https://review.openstack.org/#/q/status:open+branch:master+topic:separate-user-guide,n,z : A list of patches to review as a priority to.
+
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.log.html
  
−
== Team members ==
+
Meeting 19/05/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-21.01.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-21.01.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-21.01.log.html
 +
 
 +
  APAC Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-23.31.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-23.31.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-05-18-23.31.log.html
 +
 
 +
Meeting 03/23/16
 +
US Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-21.20.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-21.20.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-21.20.log.html
 +
 
 +
APAC Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-23.39.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-23.39.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-23-23.39.log.html
 +
 
 +
Meeting: 03/09/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-09-22.03.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-09-22.03.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-09-22.03.log.html
 +
 
 +
APAC Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-10-00.33.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-10-00.33.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-03-10-00.33.log.html
 +
 
 +
Meeting: 02/25/16
 +
US Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-22.11.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-22.11.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-22.11.log.html
 +
 +
  APAC Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-23.33.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-23.33.txt
 +
*  Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-24-23.33.log.html
 +
 
 +
 
 +
 
 +
Meeting: 02/18/16 (Additional Meeting)
 +
  US Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-17-22.17.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-17-22.17.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-17-22.17.log.html
 +
 
 +
  APAC Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-18-00.05.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-18-00.05.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-18-00.05.log.html
 +
 
 +
 
 +
Meeting: 02/11/16
 +
  US Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docsuserguides/2016/docsuserguides.2016-02-10-22.10.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docsuserguides/2016/docsuserguides.2016-02-10-22.10.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docsuserguides/2016/docsuserguides.2016-02-10-22.10.log.html
 +
 
 +
  APAC Meeting
 +
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-10-23.33.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-10-23.33.txt
 +
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-02-10-23.33.log.html
 +
 
 +
 
 +
Meeting: 01/27/16
 +
* Minutes: http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-01-27-23.31.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-01-27-23.31.txt
 +
* Log: http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-01-27-23.31.log.html
 +
 
 +
 
 +
Meeting: 12/17/15
 +
* Minutes: http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-12-16-23.31.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-12-16-23.31.txt
 +
* Log: http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-12-16-23.31.log.html
 +
 
 +
 
 +
Meeting: 11/25/2015
 +
* Minutes: http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-11-25-23.44.html
 +
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-11-25-23.44.txt
 +
* Log: http://eavesdrop.openstack.org/meetings/docuserguides/2015/docuserguides.2015-11-25-23.44.log.html
  
−
* Brian Moss, Rackspace, Brisbane Australia (UTC+10)
 
−
* Joseph Robinson, Brisbane Australia (UTC+10)
 
−
* Tanja Roth, SUSE, Germany (UTC+1)
 
−
* Bernd Bausch, Japan. Not quite certain yet to what extent I can contribute.
 
−
* Deepti Navale, Red Hat, Sydney Australia (UTC+10)
 
−
* Alexandra Settle, Rackspace, Brisbane Australia (UTC+10)
 
−
* Darren Chan, Rackspace, Canberra Australia (UTC+10)
 
  
−
----
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 05:17, 6 April 2017

We are the User Guides Specialty team!

About the User Guide team

This team is all about the users. We support companies who reuse upstream content from the guides, and focus on information architecture, consistency, and conventions in the guides.

We maintain:

  • Openstack Admin Guide
  • End User Guide

For the Install Guide and the Networking Guide, see those respective speciality groups.

Quick links

Team members

  • Joseph Robinson, Team Lead, Rackspace, Brisbane Australia (UTC+10)
  • Gudrun Wolfgram, IBM, US.
  • Linette Williams, IBM, US.
  • Bernd Bausch, Japan. Not quite certain yet to what extent I can contribute.
  • Tanja Roth, SUSE, Germany (UTC+1)
  • Emett Speer, Vancouver, Canada (UTC+8)
  • Alexandra Settle, Rackspace, London, United Kingdom (UTC)
  • Brian Moss, Rackspace, Brisbane Australia (UTC+10)
  • Darren Chan, Rackspace, Canberra Australia (UTC+10)
  • Deepti Navale, Red Hat, Sydney Australia (UTC+10)

Housekeeping

Meetings

The User Guide Specialty Team Meetings previously ran monthly on IRC. Currently, these meetings are suspended, with the options of using the time for User Guide discussion if needed. User Guides are regularly discussed in the OpenStack Docs Meeting

We hold one monthly meeting on the #openstack-meeting-4 IRC channel:


We have a page with instructions on running meetings with MeetBot, which is the same tracker used in the Weekly OpenStack Docs meetings - Meeting Instructions and Agenda

Get an ical file here: http://eavesdrop.openstack.org/#Documentation_User_Guides_Team_Meeting

Previous meetings took place on Google Hangouts - Meeting link: User Guide Team Hangout

Agenda for next meeting

The meeting agenda page - Meeting Instructions and Agenda

MeetingLogs

Meeting 09/11/16


Meeting 02/11/16 

US Meeting

APAC Meeting

Meeting 21/09/16 

US Meeting

APAC Meeting

Meeting 21/07/16 

US Meeting

APAC Meeting
  • No Meeting this fortnight

Meeting 07/07/16 

US Meeting

APAC Meeting
  • No meeting this fortnight

Meeting 15/06/16 

US Meeting

APAC Meeting
  • No meeting this fortnight

Meeting 02/06/16 

US Meeting

APAC Meeting

Meeting 19/05/16 

US Meeting

 APAC Meeting

Meeting 03/23/16 

US Meeting

APAC Meeting

Meeting: 03/09/16 

US Meeting

APAC Meeting

Meeting: 02/25/16 

US Meeting

 APAC Meeting


Meeting: 02/18/16 (Additional Meeting) 

 US Meeting

 APAC Meeting


Meeting: 02/11/16 

 US Meeting

 APAC Meeting


Meeting: 01/27/16


Meeting: 12/17/15


Meeting: 11/25/2015

Retrieved from "https://wiki.openstack.org/w/index.php?title=User_Guides&oldid=153045"