Revision as of 14:42, 9 February 2017

Documentation Newsletters

This is where I draft the 'What's Up, Doc?' documentation newsletters. The newsletter is distributed every second Friday (ish), to the openstack-docs mailing list. If you want to be added to the distribution list, or have content to add, please edit these sections:

Distribution List

OpenStack Docs Mailing List <Openstack-docs@lists.openstack.org>
OpenStack Development Mailing List <openstack-dev@lists.openstack.org>
Docs liaisons (from https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation)
i18n List <openstack-i18n@lists.openstack.org>

Content Sources

Speciality team reports are gathered in the docs meeting every two weeks. If you are a speciality team leader and can't attend the meeting, please either send a proxy to the meeting, or email your report to the meeting chair ahead of time.

If you have something that you would like to add to the next newsletter, please add it here:

Looking for older editions?

You can see older newsletters here: Documentation/WhatsUpDoc_Archive

10 February 2017

Team team team team team,

Welcome to my first edition of What's up, Doc!

Firstly, I just want to thank everyone who supported me when I announced I would like to run for manuals PTL. Although I ran the election uncontested (like the beginning of all good dictatorships), it was wonderful to receive messages of support from everyone. So, thank you!

Now, let's get down to business! We have a very short window now between Ocata and the start of Pike (2 weeks), and we still have quite a number of things left to achieve. - If anyone has time to dedicate to Install Guide testing - please sign up (links below). Thanks to those who have already volunteered to help Lana out! - As per my email yesterday, I'd love to see some people out there smashing bugs!

What have you been up to, Miss PTL? So glad you asked!

Other than plodding through my massive list of emails, I've been working on finding appropriate ways to deal with our continuously growing bug list. Step one? Deal with bug triaging. Up until this point we haven't really had an official way for bugs to be managed. So, what is hopefully one step in the right direction, for the Pike release we will have dedicated bug-triagers who will rotate on a bi-weekly basis. The roster can be found here: I've also been trying to find ways to deal with some of our guides that have higher technical debt than others. Here's some updates:

1. The Security team has agreed to join forces with us and discuss momentum going forward at the PTG. The bug tracking for the Security Guide bugs can now be found here: https://bugs.launchpad.net/ossp-security-documentation 2. The neutron team has agreed to working with John Davidge on the Networking Guide at the PTG. If anyone is interested in joining him in a working session, get in contact with him! Big thanks to John who has smashed bugs this week lowering the Networking Guide bug count down to 12! 3. The HA guide is now in the hands of Ianeta Hutchison. Ianeta (OSIC) will be working on a best plan of attack with our SMEs Andrew Beekhof, Adam Spiers, and Ben Silverman. If anyone is interested in working on that team, let Ianeta (or me) know!

Progress towards Ocata

15 days to go!
Closed 253 bugs so far. We have 139 open bugs left: https://bugs.launchpad.net/openstack-manuals/+bugs
Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting

The Road to PTG in Atlanta

Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together. Everyone welcome! Conversation topics for Docs and i18n here: https://etherpad.openstack.org/p/docs-i18n-ptg-pike

Event info is available here: http://www.openstack.org/ptg Purchase tickets here: https://pikeptg.eventbrite.com/ Tickets for the Boston summit: https://www.openstack.org/summit/boston-2017/

The CFP is now closed.

Speciality Team Reports

KATO Tomoyuki, CLI and Config Reference

CLI Reference: Updated some CLI references. Added aodhclient.
Config Reference: Start working on Ocata updates.

Doc team meeting

Our next meeting will be on Thursday 23 February at 2100 UTC in #openstack-meeting-alt

Meeting chair will be me (Alexandra Settle - asettle)! \o/

For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting

--

Have a great weekend!

Alex
All round badass and supernaturally good potato peeler

IRC: asettle
Twitter: dewsday

@@ Line 19: / Line 19: @@
 You can see older newsletters here: [[Documentation/WhatsUpDoc_Archive]]
-= 13 January 2017 =
+= 10 February 2017 =
-Hi everyone,
+Team team team team team,
-I must confess, I'm feeling a little sad. This is my very last What's Up, Doc. Next week, I'll be handling the Docs PTL mantle to Alexandra Settle. I've worked with Alex in varying capacities over many years, and I have no doubt that she will be a fabulous PTL. I'm really looking forward to working with her, and seeing what new directions she's able to take this team. I want to take this opportunity to thank each and every one of you for your continued support and encouragement over the last two years (and almost-four releases!). I have had an absolute ball doing this job, and it's all because of the amazing people I get to work with every day. Of course, I'm not going anywhere just yet. I will stay on as a core contributor, and continue to help out as much as I can.
+Welcome to my first edition of What's up, Doc!
-In the meantime, we have a release to get out the door! We now only have 26 days until Ocata is released, please keep an eye on the docs mailing list for updates, and consider getting your hands dirty with some Install Guide testing: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting
+Firstly, I just want to thank everyone who supported me when I announced I would like to run for manuals PTL. Although I ran the election uncontested (like the beginning of all good dictatorships), it was wonderful to receive messages of support from everyone. So, thank you!
-== Progress towards Ocata ==
+Now, let's get down to business! We have a very short window now between Ocata and the start of Pike (2 weeks), and we still have quite a number of things left to achieve.
+- If anyone has time to dedicate to Install Guide testing - please sign up (links below). Thanks to those who have already volunteered to help Lana out!
+- As per my email yesterday, I'd love to see some people out there smashing bugs!
-days to go!
+== What have you been up to, Miss PTL? So glad you asked! ==
-Closed 211 bugs so far.
+Other than plodding through my massive list of emails, I've been working on finding appropriate ways to deal with our continuously growing bug list. Step one? Deal with bug triaging. Up until this point we haven't really had an official way for bugs to be managed. So, what is hopefully one step in the right direction, for the Pike release we will have dedicated bug-triagers who will rotate on a bi-weekly basis. The roster can be found here:
+I've also been trying to find ways to deal with some of our guides that have higher technical debt than others. Here's some updates:
-Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables
+. The Security team has agreed to join forces with us and discuss momentum going forward at the PTG. The bug tracking for the Security Guide bugs can now be found here: https://bugs.launchpad.net/ossp-security-documentation
-Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting
+. The neutron team has agreed to working with John Davidge on the Networking Guide at the PTG. If anyone is interested in joining him in a working session, get in contact with him!  Big thanks to John who has smashed bugs this week lowering the Networking Guide bug count down to 12!
+. The HA guide is now in the hands of Ianeta Hutchison. Ianeta (OSIC) will be working on a best plan of attack with our SMEs Andrew Beekhof, Adam Spiers, and Ben Silverman. If anyone is interested in working on that team, let Ianeta (or me) know!
-== The Road to PTG in Atlanta ==
+== Progress towards Ocata ==
-Event info is available here: http://www.openstack.org/ptg
+* 15 days to go!
-Purchase tickets here: https://pikeptg.eventbrite.com/
+* Closed 253 bugs so far. We have 139 open bugs left: https://bugs.launchpad.net/openstack-manuals/+bugs
+* Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables
+* Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting
-Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together.
+== The Road to PTG in Atlanta ==
+Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together. Everyone welcome!
 Conversation topics for Docs and i18n here: https://etherpad.openstack.org/p/docs-i18n-ptg-pike
-Also, a quick note that the CFP and ticket sales for *Boston in May* are now open: https://www.openstack.org/summit/boston-2017/call-for-presentations/
-== Speciality Team Reports ==
-No speciality team reports this week, as we didn't have quorum for the docs meeting.
-== Doc team meeting ==
-Our next meeting will be on Thursday 9 Februarey at 2100 UTC in #openstack-meeting-alt
-Meeting chair will be Alexandra Settle.
-For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting
---
-Keep on doc'ing!
-Lana
-https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#27_January_2017
-= 13 January 2017 =
-Hi everyone,
-Welcome to 2017. I hope you all had a chance to rest up a little before we hurtle straight into another release, as Ocata is now only 40 days away! I'll be in contact with our lovely release managers Brian and Mariia over the next week or so to kick off release management tasks. We will need people to test the Installation Guide again, too, so if you're interested in helping out there, please let me know.
-As many of you already know, I'm not planning on running for Pike PTL. PTL nominations open in the week of 23 January, and I'll be working with Alex and Kato-san who have both expressed interest in taking on this role. If you're interested in running for PTL (for Pike or any future release), and would like a crash course in PTLing, please let me know and I can share whatever meagre wisdom I've gleaned.
-== Progress towards Ocata ==
-days to go!
-Closed 149 bugs so far.
-Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables
-== The Road to PTG in Atlanta ==
 Event info is available here: http://www.openstack.org/ptg
 Purchase tickets here: https://pikeptg.eventbrite.com/
+Tickets for the Boston summit: https://www.openstack.org/summit/boston-2017/
-Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together.
+The CFP is now closed.
-The incoming PTL will be responsible for planning and running sessions at the Atlanta PTG.
-Also, a quick note that the CFP and ticket sales for *Boston* in May are now open: https://www.openstack.org/summit/boston-2017/call-for-presentations/
 == Speciality Team Reports ==
-* API: Anne Gentle
+KATO Tomoyuki, CLI and Config Reference
-Fairy-slipper is being retired. It was a good tool, served its purpose, and can now traipse into the sunset, thanks to AJaeger and stevemar for the help with the patches. Be sure to follow the service catalog naming conventions work going on in the API WG. And there's also a new EC2 API reference: http://developer.openstack.org/api-ref/ec2-api/
+* CLI Reference: Updated some CLI references. Added aodhclient.
+* Config Reference: Start working on Ocata updates.
-* Configuration Reference and CLI Reference: Tomoyuki Kato
+== Doc team meeting ==
-Config Reference: Updated a few plug-ins. CLI reference: Updated a few command references and removed unsupported Block Storage API v1 and Image API v1.
-* High Availability Guide: Andrew Beekhof
+Our next meeting will be on Thursday 23 February at 2100 UTC in #openstack-meeting-alt
-No report this week
-* Hypervisor Tuning Guide: Joe Topjian
+Meeting chair will be me (Alexandra Settle - asettle)! \o/
-No report this week
-* Installation guides: Lana Brindley
-Testing for Ocata will be opening soon. Also, we need a web dev for the landing page, if you know of anyone, please get me in touch.
-* Networking Guide: John Davidge
-No update this week.
-* Operations and Architecture Design guides: Darren Chan
-Ben Silverman has spent some time refining the Compute content in the Arch Guide draft. Thanks Ben! We are also looking for more SMEs to help with the Arch Guide. So if you're interested, contact asettle or me.
-* Security Guide: Nathaniel Dillon
-No update this week.
-* Training Guides: Matjaz Pancur
-No update this week.
-* Training labs: Pranav Salunke, Roger Luethi
-No update this week.
-* User guides: Joseph Robinson
-The command conversions have happened at a good pace, the User Guide appears to be mostly complete, with the condition that the trove and manila teams do not have OpenStack commands yet. I have started checking through the Admin Guide files. I suspect there is more to convert, but it should be ready for Ocata.
-== Doc team meeting ==
-Our next meeting will be on Thursday 27 January at 2100 UTC in #openstack-meeting-alt
 For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting
@@ Line 137: / Line 74: @@
 --
-Keep on doc'ing!
+Have a great weekend!
-Lana
-https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#13_January_2017
+Alex
+<br />
+All round badass and supernaturally good potato peeler
+<br />
+<br />
+IRC: asettle
+<br />
+Twitter: dewsday

Difference between revisions of "Documentation/WhatsUpDoc"