Open Stack

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

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 at lanabrindley.com. I've also decided to start drafting these
'in the open' (as it were). If you want to see my early drafts and
typos, or check on old newsletters, you can do so here:
https://wiki.openstack.org/w/index.php?title=Documentation/WhatsUpDoc

=== Design Summit ===

The Design Summit was 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.

* Install Guide:
** Contact Karin Levenstein <karin.levenstein at rackspace.com>
** Blueprint:
https://blueprints.launchpad.net/openstack-manuals/+spec/installguide-liberty
** Spec WIP: https://review.openstack.org/#/c/183138/

* Cloud Admin Guide:
** Contact Brian Moss <kallimachos at gmail.com> & Joseph Robinson
<joseph.r.email at gmail.com>
** Blueprint:
https://blueprints.launchpad.net/openstack-manuals/+spec/reorganise-user-guides
** Sign up to help out here:
https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration

* HA Guide
** Contact Meg McRoberts <dreidellhasa at yahoo.com> or Matt Griffin
<matt.griffin at percona.com>
** Blueprint:
https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide


=== 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 held 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
APAC: Wednesday 10 June, 00:30: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

Thanks!
Lana



- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQEcBAEBAgAGBQJVZ8zbAAoJELppzVb4+KUyRo4H/256BF1RUL+or3lh8GSNSTGM
YZLYem1eN4cywwcjWfcwHThXvHG8wpBbW8eoZ7wTKLrVXStiYuxZOM7qPg9QZZAx
NLj+GCcNl96HGCjczCqT7M0N41uKQKLXAJTdUCFmUvvapG7sTfQQyI0HYV24H3Lz
EDxhQN1efA7SPAgspP25iv3bNueAAcZI3JcXhz3TSRhBZVfOIcOL6a04fy1tU/RX
WKY+njHd3Nyg4qoiX37Nn17Op+DzNZEsiF40OiwQ5/Diwxz+UWD3DWXIX0huuRxT
yhWn1Yo31iiQy0dGSabXlTX1E6hWAnwT9dhvBJUrhgusuN7Tq5mzNT1tza6XJs0=
=ZrQH
-----END PGP SIGNATURE-----