Jump to: navigation, search

Difference between revisions of "Documentation/WhatsUpDoc"

(9 September 2016)
Line 24: Line 24:
 
Hi everyone,
 
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
+
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 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.  
+
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 ==
 
== Progress towards Newton ==
  
33 days to go!
+
26 days to go!
  
Bugs closed so far: 407
+
Bugs closed so far: 428
  
 
Release managers: Olena Logvinova and Alexandra Settle
 
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
 
Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting
Line 41: Line 43:
  
 
* 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 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
 
* 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 ==
+
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
  
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.
+
== 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 ==
 
== Speciality Team Reports ==
  
 
'''HA Guide: Andrew Beekhof'''
 
'''HA Guide: Andrew Beekhof'''
No report this week.
+
Organizing a HA meetup at summit
 +
Intention is get an update plan finalized shortly
  
 
'''Install Tutorials: Lana Brindley'''
 
'''Install Tutorials: Lana Brindley'''
Line 66: Line 76:
  
 
'''Ops Guide: Shilla Saebi, Darren Chan'''
 
'''Ops Guide: Shilla Saebi, Darren Chan'''
No meeting last week in light of the ops mid cycle and OpenStack East conference
+
No report this week.
Updating  use cases chapter in Arch Guide
 
Looking for more enterprise troubleshooting docs to push upstream for the ops guide
 
  
 
'''API Guide: Anne Gentle'''
 
'''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/
+
Working on an article for Super User describing the switchover in API guide sources to project repos and the new navigation.
Improvements to the sidebar link collection: https://review.openstack.org/#/c/362436/
 
  
 
'''Config/CLI Ref: Tomoyuki Kato'''
 
'''Config/CLI Ref: Tomoyuki Kato'''
Updated some CLI reference. Closed some bugs for Config Reference.
+
Consolidating the OSC command reference into the OSC specific doc.
  
 
'''Training labs: Pranav Salunke, Roger Luethi'''
 
'''Training labs: Pranav Salunke, Roger Luethi'''
Line 81: Line 88:
  
 
'''Training Guides: Matjaz Pancur'''
 
'''Training Guides: Matjaz Pancur'''
No report this week.
+
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
 
'''Hypervisor Tuning Guide: Blair Bethwaite
Line 91: Line 99:
 
== Site Stats ==
 
== Site Stats ==
  
For the month of August, we had a 6% increase in traffic over July.
+
 
  
 
== Doc team meeting ==
 
== Doc team meeting ==
Line 97: Line 105:
 
Next meetings:
 
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
+
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:
 
Next meetings:
APAC: Wednesday 7 September, 00:30 UTC
 
 
US: Wednesday 14 September, 19:00 UTC
 
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
 
Please go ahead and add any agenda items to the meeting page here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting

Revision as of 03:36, 9 September 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

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

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.

Site Stats

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

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