Jump to: navigation, search

Difference between revisions of "Documentation/WhatsUpDoc"

(29 May 2015)
(29 May 2015)
Line 34: Line 34:
 
** Contact Meg McRoberts <dreidellhasa@yahoo.com>
 
** Contact Meg McRoberts <dreidellhasa@yahoo.com>
 
** Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide
 
** Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide
 +
  
 
__New Core Reviewer Process__
 
__New Core Reviewer Process__

Revision as of 00:33, 28 May 2015

29 May 2015

Hi everyone,

Continuing in Anne's fine tradition, I intend to send these out every Friday. If you have content you would like to add, or you would like to be added to the distribution list, please email me directly at openstack@lanabrindley.com.

__Design Summit__

The Design Summit was, I think, a great success. We had ten sessions for docs overall, including two workgroups and a contributors' meetup. Thanks to everyone who came along (or participated remotely!) and had their say on the Liberty release. I've been spending time gathering my thoughts after the Summit, and have summarised the etherpad notes on the wiki here: https://wiki.openstack.org/w/index.php?title=Documentation/Liberty You can also see the original etherpads here: https://wiki.openstack.org/wiki/Design_Summit/Liberty/Etherpads#Documentation

In short, the main things I would like us to achieve for Liberty are:

  • RST conversion: Install Guide, Cloud Admin Guide, HA Guide
  • User Guides information architecture overhaul.
  • Greater focus on helping out devs with docs in their repo
  • Improve how we communicate with and support our corporate contributors

If you have a burning issue that didn't get addressed during the Summit, or that you think I've forgotten, now would be your chance to tell me about it! Look out for Blueprints and Specs for this work over the next couple of weeks.

__RST Migration__

The next books we are focusing on for RST conversion are the Install Guide, Cloud Admin Guide, and the HA Guide. If you would like to assist, please get in touch with the appropriate speciality team.


__New Core Reviewer Process__

One of the simpler changes I was asked to implement at the Design Summit was a new core reviewer process, with the aim of making it a more balanced approach to selecting core team members. We decided on a process that combines a monthly statistics-based selection process with a continuous nomination-based process. I've written up the details on the HowTo here: https://wiki.openstack.org/wiki/Documentation/HowTo#Achieving_core_reviewer_status and will implement the first round on 1 June.

__Doc team meeting__

APAC meeting was help this week, see the minutes here to catch up: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2015-05-27

Thanks to Joe for holding the APAC fort while I was travelling!

Next meetings are: US: Wednesday 3 June, 14:00:00 UTC #openstack-meeting APAC: Wednesday 10 June, 00:30:00 UTC #openstack-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

Thanks! Lana