Jump to: navigation, search

Difference between revisions of "Documentation/OpsGuide"

(Agenda for the next meeting)
m
 
(47 intermediate revisions by 3 users not shown)
Line 5: Line 5:
  
 
= Team Members =
 
= Team Members =
* Shilla Saebi (Shilla.Saebi@gmail.com)  
+
* Darren Chan (darrenc) - team lead
* Alexandra Settle (alexandra.settle@outlook.com)
+
* Shilla Saebi (saeini)  
* Darren Chan (dazzachan@yahoo.com.au)
+
* Alexandra Settle (asettle)
* Victor Howard (victor.r.howard@gmail.com)
+
* Ben Silverman (bsilverman_7)
* Xav Paice (xavpaice@gmail.com)
+
* Victor Howard  
 +
* Xav Paice  
 
* Nate Johnson
 
* Nate Johnson
* Devon Boatwright
+
* Devon Boatwright  
 +
* Robert Starmer
 +
* Shaun O'Meara
 +
* KATO Tomoyuki (katomo)
  
= Global OpenStack Bug Smash Mitaka - 7-9 March 2016=
+
= News =
The Arch Guide work items will be converted to Launchpad bugs for the [https://etherpad.openstack.org/p/OpenStack-Bug-Smash-Mitaka global bug smash].
+
* We are continuing our work revising the Architecture Design Guide during the Pike release cycle. We would love more volunteers to contribute to the content. For enquiries, please contact Ben Silverman (bsilverman_) or Darren Chan (darrenc).
Discussion will take place on IRC in the #arch-guide-swarm channel.
 
Assign yourself a bug that is listed on the work items wiki page, or bugs tagged with *arch-guide* in [https://bugs.launchpad.net/openstack-manuals/ Launchpad].
 
Please contact Shilla or Darren if you have any questions. Thanks!
 
  
[https://etherpad.openstack.org/p/arch-guide-reorg arch guide etherpad]
+
Additional information:
 +
 
 +
* [https://review.openstack.org/#/c/436747/3 Pike specification] PLEASE REVIEW
 +
* [[Architecture Design Guide restructure work items]]  
  
[[Architecture Design Guide work items]]
 
  
 
= Meetings =
 
= Meetings =
We meet biweekly on Thursday at 2130 UTC in #openstack-meeting-3 in IRC.
+
We no longer host regular specialty team meetings. Instead, we encourage you to attend the bi-weekly docs meeting [https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting every second Thursday at 2100 UTC] in #openstack-alt.
The next meeting will be on Thursday, 21 April 2016.
 
  
[http://eavesdrop.openstack.org/#Documentation_Operations_Guide_and_Architecture_Design_Guide_Team_Meeting Meeting details]
+
The Arch Guide Working Group meet biweekly on Wednesday at 2000 UTC. To join the video meeting, enter https://vc.rackspace.com/flex.html?roomdirect.html&key=wuyup2lsi3TvqSzb2EkQf8tcbg in your web browser. Discussion also occurs in IRC #arch-dudes channel.
  
 +
==Meeting Logs==
 
[https://wiki.openstack.org/wiki/Meetings/OpsGuide-meeting-archive Meeting archive]
 
[https://wiki.openstack.org/wiki/Meetings/OpsGuide-meeting-archive Meeting archive]
  
[http://eavesdrop.openstack.org/meetings/ops_guide/ Log from past meetings]
+
[http://eavesdrop.openstack.org/meetings/ops_guide/ Specialty team]
 
 
==Agenda for the next meeting==
 
Thursday 21 April 2016
 
 
 
* Patches in review: https://review.openstack.org/#/c/304973/ https://review.openstack.org/#/c/293123/ https://review.openstack.org/#/c/303925/
 
** SMEs to write Functional Requirements, Cloud architecture examples, User Requirements chapters 
 
* Ops Guide:
 
** Conversion completed
 
** ops-guide session at the Austin summit: https://www.openstack.org/summit/austin-2016/summit-schedule/events/9511 Etherpad: https://etherpad.openstack.org/p/AUS-ops-Docs-ops-guide
 
** Please add suggestions to improve the ops-guide in https://etherpad.openstack.org/p/ops-guide-reorg. There was an ops-guide session at the Liberty Ops Mid-cycle with comments in https://etherpad.openstack.org/p/PAO-ops-ops-guide-fixing. Below are some potential outcomes for the ops guide that will be discussed in Austin:
 
    - Identifying improvements and content gaps in the current guide
 
    - Establishing whether we need a need new edition or revision of the ops-guide
 
    - How we will approach revising or creating a new edition of the ops-guide
 
    - Asking who wants to get involved, and if possible delegating work.
 
 
 
= Updates =
 
 
 
*<big>Open reviews</big>
 
https://review.openstack.org/#/q/status:open+project:openstack/operations-guide,n,z
 
 
 
*<big>Kilo Operations mid-cycle meetup</big>
 
DIscussion about the ops-guide: https://etherpad.openstack.org/p/PAO-ops-ops-guide-fixing
 
 
 
*<big>Architecture Design Guide</big>
 
APAC OpenStack contributors gathered for a docs swarm on the 13-14 August in Brisbane, Australia. The focus was copy-editing the [https://blueprints.launchpad.net/openstack-manuals/+spec/arch-guide Architecture Design Guide], and there were some great discussions on reorganising and updating technical content to better meet the needs of operators and cloud architects.  This has lead to specs being drafted for RST conversion and reorganisation during the Mitaka release.
 
  
*<big>Operations Guide</big>
+
[https://etherpad.openstack.org/p/arch-guide-working-group Arch Guide Working Group]
Blueprints and specs are currently being drafted for the Mitaka release.
 
  
= Goals for the Mitaka release=  
+
=Resources=
* [https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-rst Architecture Design Guide RST conversion]
+
* [https://etherpad.openstack.org/p/BCN-Docs-OcataPlanningWG Ocata docs release plans]
* [https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-reorg Architecture Design Guide reorganisation]
+
* [https://etherpad.openstack.org/p/BCN-ops-docs_(double_session) Ocata Ops Documentation Design Summit session]
 +
* [https://review.openstack.org/#/q/status:open+project:openstack/operations-guide,n,z Ops Guide reviews]
 +
* [https://etherpad.openstack.org/p/arch-guide-reorg-newton Mitaka content migration].

Latest revision as of 00:38, 28 February 2017


About the Ops/Arch Guide specialty team

Specialty team for developing and maintaining the Operations Guide and Architecture Design Guide.

Team Members

  • Darren Chan (darrenc) - team lead
  • Shilla Saebi (saeini)
  • Alexandra Settle (asettle)
  • Ben Silverman (bsilverman_7)
  • Victor Howard
  • Xav Paice
  • Nate Johnson
  • Devon Boatwright
  • Robert Starmer
  • Shaun O'Meara
  • KATO Tomoyuki (katomo)

News

  • We are continuing our work revising the Architecture Design Guide during the Pike release cycle. We would love more volunteers to contribute to the content. For enquiries, please contact Ben Silverman (bsilverman_) or Darren Chan (darrenc).

Additional information:

* Pike specification PLEASE REVIEW
* Architecture Design Guide restructure work items 


Meetings

We no longer host regular specialty team meetings. Instead, we encourage you to attend the bi-weekly docs meeting every second Thursday at 2100 UTC in #openstack-alt.

The Arch Guide Working Group meet biweekly on Wednesday at 2000 UTC. To join the video meeting, enter https://vc.rackspace.com/flex.html?roomdirect.html&key=wuyup2lsi3TvqSzb2EkQf8tcbg in your web browser. Discussion also occurs in IRC #arch-dudes channel.

Meeting Logs

Meeting archive

Specialty team

Arch Guide Working Group

Resources

* Mitaka content migration.