Jump to: navigation, search

Difference between revisions of "User Guides"

(→‎About the User Guide team)
(→‎Meetings)
 
(120 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 Wednesdays at 22:30 UTC (Thursday 8:30am Australian Eastern Standard Time or GMT+10), on Google Hangout, link in the invite. If you're not on the invite 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)
 +
 
 +
 
 +
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]
 +
 
 +
Get an ical file here: http://eavesdrop.openstack.org/#Documentation_User_Guides_Team_Meeting
 +
 
 +
Previous meetings took place on Google Hangouts  - Meeting link: [https://plus.google.com/hangouts/_/calendar/OHEzajk1ZjB2djRmZW9tMnB1cjNsdGRrMWtAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ.8amajg4mrflp20h0fi0ij7mlmo User Guide Team Hangout]
  
 
=== Agenda for next meeting ===
 
=== Agenda for next meeting ===
−
*Thursday 05/28/15
+
The meeting agenda page - [https://wiki.openstack.org/wiki/Meetings/DocUserGuidesTeamMeeting Meeting Instructions and Agenda]
−
**The Cloud Admin Guide RST Conversion is now a priority follow the summit. So this crosses off a question from
+
 
−
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.
+
===MeetingLogs===
−
**There is now a new heading on the RST conversion task tracking page.
+
Meeting 09/11/16
−
**Question for experienced writers - Where to start from here?
+
 
−
*IA Update:
+
* Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.html
−
** Rename the Virtual Machine Image Guide to the Cloud Image Guide
+
* Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.txt
−
** Admin Guide versioning. One consideration is to add versioning to the Admin Guide
+
* Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-11-10-06.34.log.html
−
**Rewriting the How-To section, resulting in doc that has ease of readability. This must avoid duplication of the infra-manual.
+
 
 +
 
 +
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
  
−
* Thursday 05/14/15
+
Meeting 07/07/16
−
** Will the scope include Cloud Admin Guide alongside the User and Admin Guides?
+
US Meeting
−
** The tasks tracking page is now active: https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides
+
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-07-06-21.01.html
−
** 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.
+
*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
 +
 
 +
APAC Meeting
 +
* No meeting this fortnight
 +
 
 +
Meeting 15/06/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-15-21.06.log.html
 +
 
 +
APAC Meeting
 +
* No meeting this fortnight
 +
 
 +
Meeting 02/06/16
 +
US Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-21.00.log.html
 +
 
 +
APAC Meeting
 +
*Minutes:        http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.html
 +
*Minutes (text): http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.txt
 +
*Log:            http://eavesdrop.openstack.org/meetings/docuserguides/2016/docuserguides.2016-06-01-23.30.log.html
 +
 
 +
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
  
−
== Team members ==
 
−
* Lana Brindley, Rackspace, Brisbane Australia (UTC+10)
 
−
* Tanja Roth, SUSE, Germany (UTC+1)
 
−
* Joseph Robinson, Brisbane Australia (UTC+10)
 
−
* Matt Kassawara, Rackspace, US/Central
 
−
* 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)
 
−
* Brian Moss, Rackspace, Brisbane 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"