Jump to: navigation, search

Difference between revisions of "Documentation/WhatsUpDoc"

(7 October 2016)
Line 20: Line 20:
 
You can see older newsletters here: [[Documentation/WhatsUpDoc_Archive]]
 
You can see older newsletters here: [[Documentation/WhatsUpDoc_Archive]]
  
= 7 October 2016 =
+
= 18 November 2016 =
  
 
Hi everyone,
 
Hi everyone,
Line 60: Line 60:
 
Lana
 
Lana
  
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#7_October_2016
+
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#18_November_2016
 
 
= 30 September 2016 =
 
 
 
Hi everyone,
 
 
 
We're on the final countdown to Newton now! The release managers Olena and Alex are busy getting the release patches ready, the Install Guide testing team are madly working through the last few sections, and Andreas and I have our fingers hovering over the big red GO button! Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release.
 
 
 
Please be aware that the core team will not be merging non-critical patches until after we've branched for Newton, particularly for the Installation Guide. We usually cut the branch about a week after Summit concludes, so you might be asked to wait until then. If that happens, a core will -2 your patch until after we've branched.
 
 
 
== Progress towards Newton ==
 
 
 
5 days to go!
 
 
 
Bugs closed so far: 466
 
 
 
Release managers: Olena Logvinova and Alexandra Settle
 
 
 
Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease
 
 
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
== The Road to Barcelona ==
 
 
 
I have a draft schedule up, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know.
 
 
 
== Core Team Reviews ==
 
 
 
Just a quick note that we won't be holding a core team review in October, as it conflicts with release, or in November, as it conflicts with Summit. We'll resume these in December for the Newton cycle.
 
 
 
== Doc team meeting ==
 
 
 
Next meetings:
 
 
 
The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-28
 
 
 
Next meetings:
 
APAC: Wednesday 5 October, 00:30 UTC (This will be the final meeting before release day!)
 
US: Wednesday 12 October, 19:00 UTC
 
 
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
 
 
 
--
 
 
 
Keep on doc'ing!
 
 
 
Lana
 
 
 
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#30_September_2016
 
 
 
= 23 September 2016 =
 
 
 
Hi everyone,
 
 
 
Newton goes out in just two weeks, and the release team and I have been busy working through release tasks in preparation. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release.
 
 
 
I'm also pleased to announce that I have been returned as the documentation PTL for Ocata, which will be my fourth term. Thanks for all the support!
 
 
 
== Progress towards Newton ==
 
 
 
12 days to go!
 
 
 
Bugs closed so far: 455
 
 
 
Release managers: Olena Logvinova and Alexandra Settle
 
 
 
Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease
 
 
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
== The Road to Barcelona ==
 
 
 
* I have a draft schedule starting to take shape, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know.
 
* By now, you should be well on the way to having your travel and accommodation booked for Barcelona. In case you're still working on it, though, there's travel information available on the Summit site here: https://www.openstack.org/summit/barcelona-2016/travel/
 
* Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg
 
 
 
== Doc team meeting ==
 
 
 
Next meetings:
 
 
 
The APAC meeting was skipped this week.
 
 
 
Next meetings:
 
US: Wednesday 28 September, 19:00 UTC
 
APAC: Wednesday 5 October, 00:30 UTC
 
 
 
These two meetings will be the final meetings before release day.
 
 
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
 
 
 
--
 
 
 
Keep on doc'ing!
 
 
 
Lana
 
 
 
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#23_September_2016
 
 
 
= 16 September 2016 =
 
 
 
Hi everyone,
 
 
 
Newton goes out in three weeks, and the release team and I have been busy working with our cross-project liaisons to ensure the docs suite is up to date and ready to go. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release.
 
 
 
This week, I've also been working on Summit planning, and drafting my PTL candidacy, which you can read here: http://lists.openstack.org/pipermail/openstack-docs/2016-September/009112.html Big thanks to everyone who has emailed me over the past few days to offer their support. Knowing you all have my back is the reason I keep doing this :) 
 
 
 
== Progress towards Newton ==
 
 
 
19 days to go!
 
 
 
Bugs closed so far: 444
 
 
 
Release managers: Olena Logvinova and Alexandra Settle
 
 
 
Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease
 
 
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
== The Road to Barcelona ==
 
 
 
* I have a draft schedule starting to take shape, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know.
 
* By now, you should be well on the way to having your travel and accommodation booked for Barcelona. In case you're still working on it, though, there's travel information available on the Summit site here: https://www.openstack.org/summit/barcelona-2016/travel/
 
* Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg
 
 
 
== Speciality Team Reports ==
 
 
 
This will be the last Speciality Team report before we release Newton, as focus shifts to final preparations, testing, and release notes. I'd like to take this opportunity to thank all our speciality team leads, who work very hard behind the scenes to keep their books in top shape, and their teams working together towards a common goal. Our docs suite wouldn't be what it is without these hard working people.
 
 
 
'''HA Guide: Andrew Beekhof'''
 
No report this week.
 
 
 
'''Install Tutorials: Lana Brindley'''
 
Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting Next meeting: 27 September August 0600UTC.
 
 
 
'''Networking Guide: Edgar Magana'''
 
No report this week.
 
 
 
'''Security Guide: Nathaniel Dillon'''
 
No report this week.
 
 
 
'''User Guides: Joseph Robinson'''
 
No report this week.
 
 
 
'''Ops Guide: Shilla Saebi, Darren Chan'''
 
No report this week.
 
 
 
'''API Guide: Anne Gentle'''
 
Working with teams who want to write guides similar to FirstApp: Murano and Heat for example.
 
This patch moves Cinder v1 API to Deprecated: https://review.openstack.org/#/c/370407/ Thanks Mark Voelker for all the links to go with the patch!
 
 
 
'''Config/CLI Ref: Tomoyuki Kato'''
 
Updating Configreference for Newton release. We need to help, especially for vendor plug-in configuration.
 
 
 
'''Training labs: Pranav Salunke, Roger Luethi'''
 
No report this week.
 
 
 
'''Training Guides: Matjaz Pancur'''
 
No report this week.
 
 
 
'''Hypervisor Tuning Guide: Blair Bethwaite
 
No report this week.
 
 
 
'''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero'''
 
No report this week.
 
 
 
== Doc team meeting ==
 
 
 
Next meetings:
 
 
 
The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-14
 
 
 
Next meetings:
 
APAC: Wednesday 21 September, 00:30 UTC
 
US: Wednesday 28 September, 19:00 UTC
 
 
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
 
 
 
--
 
 
 
Keep on doc'ing!
 
 
 
Lana
 
 
 
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#16_September_2016
 
 
 
= 9 September 2016 =
 
 
 
Hi everyone,
 
 
 
Only four weeks to go until Newton! Andreas, Brian, Olga, and I met with our new release managers Olena and Alex a few days ago, and we're all ready and waiting with bated breath to get started on the release. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release.
 
 
 
This week, I've also done a core team review, and we bid farewell to two core team members. More on that in this newsletter.
 
 
 
== Progress towards Newton ==
 
 
 
26 days to go!
 
 
 
Bugs closed so far: 428
 
 
 
Release managers: Olena Logvinova and Alexandra Settle
 
 
 
Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease
 
 
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
== The Road to Barcelona ==
 
 
 
* If there's something you want to make sure we discuss at Summit, please put your ideas here: https://etherpad.openstack.org/p/Ocata-DocsSessions When we get our room allocations, I'll organise it into a schedule.
 
* If you require a visa invitation letter to travel to Spain, then you need to fill out the form here: https://www.openstack.org/summit/barcelona-2016/travel/#visa
 
 
 
Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg
 
 
 
== Core Team Review ==
 
 
 
The core team have completed their review for August, and I'm a bit sad to announce that both Atsushi Sakai and Gauvain Pocontek are no longer core team members.
 
 
 
Gauvain has been committing to OpenStack manuals since well before my time, and has been an invaluable resource for many people (including myself!) over the years. He is currently working on some new projects, but we hope to still see him around from time to time.
 
 
 
Atsushi-san joined the core team last year, and during that time has proven an extremely effective reviewer. He is still very busy on OpenStack, with an increased focus on cross-project tasks, so we will be sure to still see him around. I wish you well on your endeavours!
 
 
 
I thank you both for your commitment to being core team members, and for all your contributions. We are better because of your effort.
 
 
 
== Speciality Team Reports ==
 
 
 
'''HA Guide: Andrew Beekhof'''
 
Organizing a HA meetup at summit
 
Intention is get an update plan finalized shortly
 
 
 
'''Install Tutorials: Lana Brindley'''
 
Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 13 September August 0600UTC.
 
 
 
'''Networking Guide: Edgar Magana'''
 
No report this week.
 
 
 
'''Security Guide: Nathaniel Dillon'''
 
No report this week.
 
 
 
'''User Guides: Joseph Robinson'''
 
No report this week.
 
 
 
'''Ops Guide: Shilla Saebi, Darren Chan'''
 
No report this week.
 
 
 
'''API Guide: Anne Gentle'''
 
Working on an article for Super User describing the switchover in API guide sources to project repos and the new navigation.
 
 
 
'''Config/CLI Ref: Tomoyuki Kato'''
 
Consolidating the OSC command reference into the OSC specific doc.
 
 
 
'''Training labs: Pranav Salunke, Roger Luethi'''
 
No report this week.
 
 
 
'''Training Guides: Matjaz Pancur'''
 
Finished first day of our virtual sprint series (6 Sep): Common items: https://etherpad.openstack.org/p/upstream-uni-common-items (coordinated by Ildiko Vancsa, ildikov), Code contribution: https://etherpad.openstack.org/p/upstream-uni-code-contribution (coordinated by Kendall Nelson, diablo_rojo)
 
Next virtual sprint dates: 12,13 and 16 September (https://wiki.openstack.org/wiki/VirtualSprints#Upstream_training_Sprint)
 
 
 
'''Hypervisor Tuning Guide: Blair Bethwaite
 
No report this week.
 
 
 
'''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero'''
 
No report this week.
 
 
 
== Doc team meeting ==
 
 
 
Next meetings:
 
 
 
The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-07
 
 
 
Next meetings:
 
US: Wednesday 14 September, 19:00 UTC
 
APAC: Wednesday 21 September, 00:30 UTC
 
 
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
 
 
 
--
 
 
 
Keep on doc'ing!
 
 
 
Lana
 
 
 
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#9_September_2016
 
 
 
= 2 September 2016 =
 
 
 
Hi everyone,
 
 
 
We have five weeks left until the Newton release goes out, so this week has been all about getting started on testing the Install Guide. We now have beta releases for all our distros, so thanks to our lovely package maintainers for getting back to me so quickly! We can still use more testers, though, all you need to do is sign up on the wiki page and start testing: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
This week Andreas, Brian, Olga, and I will be meeting with our new release managers Olena and Alex, to make sure they're up to speed. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release.
 
 
 
== Progress towards Newton ==
 
 
 
33 days to go!
 
 
 
Bugs closed so far: 407
 
 
 
Release managers: Olena Logvinova and Alexandra Settle
 
 
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
 
 
 
== The Road to Barcelona ==
 
 
 
* If there's something you want to make sure we discuss at Summit, please put your ideas here: https://etherpad.openstack.org/p/Ocata-DocsSessions When we get our room allocations, I'll organise it into a schedule.
 
* Talk acceptances have gone out, congratulations to everyone who got something accepted!
 
* If you require a visa invitation letter to travel to Spain, then you need to fill out the form here: https://www.openstack.org/summit/barcelona-2016/travel/#visa
 
 
 
== Docs Tools ==
 
 
 
There is a lot of cleanup happening on the docs site right now, so you might see some old and unloved content disappear. If you notice anything strange, please let Andreas or the docs mailing list know so we can get it straightened out.
 
 
 
== Speciality Team Reports ==
 
 
 
'''HA Guide: Andrew Beekhof'''
 
No report this week.
 
 
 
'''Install Tutorials: Lana Brindley'''
 
Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 13 September August 0600UTC.
 
 
 
'''Networking Guide: Edgar Magana'''
 
No report this week.
 
 
 
'''Security Guide: Nathaniel Dillon'''
 
No report this week.
 
 
 
'''User Guides: Joseph Robinson'''
 
No report this week.
 
 
 
'''Ops Guide: Shilla Saebi, Darren Chan'''
 
No meeting last week in light of the ops mid cycle and OpenStack East conference
 
Updating  use cases chapter in Arch Guide
 
Looking for more enterprise troubleshooting docs to push upstream for the ops guide
 
 
 
'''API Guide: Anne Gentle'''
 
New landing page for a collection of all API Reference docs and Guides in one place: https://review.openstack.org/#/c/361480/
 
Improvements to the sidebar link collection: https://review.openstack.org/#/c/362436/
 
 
 
'''Config/CLI Ref: Tomoyuki Kato'''
 
Updated some CLI reference. Closed some bugs for Config Reference.
 
 
 
'''Training labs: Pranav Salunke, Roger Luethi'''
 
No report this week.
 
 
 
'''Training Guides: Matjaz Pancur'''
 
No report this week.
 
 
 
'''Hypervisor Tuning Guide: Blair Bethwaite
 
No report this week.
 
 
 
'''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero'''
 
No report this week.
 
 
 
== Site Stats ==
 
 
 
For the month of August, we had a 6% increase in traffic over July.
 
 
 
== Doc team meeting ==
 
 
 
Next meetings:
 
 
 
The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-08-31
 
 
 
Next meetings:
 
APAC: Wednesday 7 September, 00:30 UTC
 
US: Wednesday 14 September, 19:00 UTC
 
 
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
 
 
 
--
 
 
 
Keep on doc'ing!
 
 
 
Lana
 
 
 
https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#2_September_2016
 

Revision as of 04:32, 18 November 2016

Documentation Newsletters

This is where I draft the 'What's Up, Doc?' documentation newsletters. The newsletter is distributed every 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

Content Sources

Speciality team reports are gathered here: https://etherpad.openstack.org/p/Speciality_Team_Reports

  • Your
  • Content
  • Here

Looking for older editions?

You can see older newsletters here: Documentation/WhatsUpDoc_Archive

18 November 2016

Hi everyone,

First of all, Newton docs are live on http://docs.openstack.org/ \o/

Thank you to our release managers, Olena and Alex, who have put in the hard yards over the past few weeks to get us in good shape. Thanks also to Andreas and Kato-san, for everything that they do, and to our speciality team leads and cross project liaisons. And thanks to Christian and Matt for the last minute assistance.

Of course, every release belongs to all of you who have written, tested, reviewed, updated, triaged, and edited over the last six months. Well done on another successful release :)

Don't forget that you can still use "#success" before a message in any OpenStack IRC channel to call out wins, they are gathered here: https://wiki.openstack.org/wiki/Successes

Progress towards Newton

Newton has been released unto the world. We fixed 479 bugs this cycle, and completed 15 blueprints.

We'll begin planning for Ocata over the next couple of weeks, culminating in the Barcelona Summit 25-28 October, where we'll develop our Ocata deliverables list. Stay tuned!

The Road to Barcelona

Our docs schedule is now available here: https://www.openstack.org/summit/barcelona-2016/summit-schedule/global-search?t=Documentation%3A

We are also hoping to have a docs session in the Ops track. I'll get back to you with more information on that as soon as I have it.

I've requested a docs track at the PTG in Atlanta next February, which will be used for Ocata review and Pike planning. Please let me know if you intend to participate.

Core Team Reviews

Just a quick note that we won't be holding a core team review in November, as it conflicts with Summit. We'll resume these in December for the Ocata cycle.

Doc team meeting

We will take a short break and resume the normal meeting schedule after Summit. In the meantime, you can catch most of us in #openstack-doc in a variety of timezones, so feel free to drop in and ask questions any time.

--

Keep on doc'ing!

Lana

https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#18_November_2016