[openstack-dev] What's Up Doc? March 26, 2015 [all]

Anne Gentle annegentle at justwriteclick.com
Fri Mar 27 00:37:13 UTC 2015


Here's the latest news installment from docsland.

Install Guides updates
-----------------------------
We've got a spec ready for the changes to the Install Guides now published
at:
http://specs.openstack.org/openstack/docs-specs/specs/kilo/installguide-kilo.html
I'm sure the keystone team will rejoice to see changes to support the
Identity v3 API by default. Also the openstack CLI will substitute for
keystone CLI commands.

Doc core team
-------------------
Removed some people from openstack-doc-core team so we now have 12 (yes
that's a dozen) doc core members who can +2 and publish a doc patch. I’m
consulting with the group to see who we can add next based on the 30 and 90
day stats for both reviews and commits.

Speciality teams
----------------------
Specialty teams are working well for docs, install guides, user guides,
security guide, ha guide, and networking guide -- specialists are working
independently in teams and planning and writing. Currently many of those
specialized review teams maintain their own core list, and can publish
their guide without needing a doc-core member.

RST Migration Updates
-------------------------------
Fixed two bugs in the OpenStack Sphinx theme that were showstoppers. Three
remain, and all of those need to be landed this week or next for us to
publish RST by April 9th (trying to beat
https://wiki.openstack.org/wiki/Kilo_Release_Schedule dates). Calling web
devs especially to take a look at these:
Bug links https://review.openstack.org/#/c/160151/
TOC links https://review.openstack.org/#/c/160354/
Search fix https://review.openstack.org/#/c/167028/

Once the End User Guide and Admin User Guide content is migrated, we will
shift focus to determine what criteria to use to migrate and publish the
next guide with RST/Sphinx. Git 'er done.

Doc Team meeting
-------------------------
The Doc team met this week and the minutes and logs are available:

Minutes:
http://eavesdrop.openstack.org/meetings/docteam/2015/docteam.2015-03-25-14.00.html

Log:
http://eavesdrop.openstack.org/meetings/docteam/2015/docteam.2015-03-25-14.00.log.html

Licensing code and content
-------------------------------------
I completed an audit of our current displayed licensing for our docs:
https://wiki.openstack.org/wiki/Documentation/ContentSpecs#Licenses

Working through the desired state which we believe to be to indicate that
code is Apache 2.0 and content is CC-by 3.0 I'm picking up tasks to make
that happen.

Thanks everyone for the hard work -- with just a dozen doc core we are
getting a lot done, with the support of the hundreds of doc contributors
this release (over 200!). Let's keep it up to get Kilo out into the world.

Anne


-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150326/075b47fa/attachment.html>


More information about the OpenStack-dev mailing list