<p dir="ltr"><br>
On Jun 11, 2014 10:33 AM, "Anne Gentle" <<a href="mailto:anne@openstack.org">anne@openstack.org</a>> wrote:<br>
><br>
> Hi all, <br>
> I'm back and mellow after my week at the beach. Here's what's going on in the world of docs.<br>
><br>
> We had our doc team meeting this morning. The 2nd and 4th Wed. are Europe and North America times, the 1st and 3rd Wed. are for Australia and Pacific area time zones. Find the meeting logs here: <a href="https://wiki.openstack.org/wiki/Documentation/MeetingLogs">https://wiki.openstack.org/wiki/Documentation/MeetingLogs</a> and all are welcome.<br>

><br>
> 1. In review and merged recently:<br>
><br>
> RabbitMQ is now in use everywhere in the install guides, rather than documenting Qpid just for Fedora/CentOS/RHEL.<br>
><br>
> The Admin User Guide has been updated for the Icehouse dashboard UI with <a href="https://review.openstack.org/#/c/98484/">https://review.openstack.org/#/c/98484/</a>.<br>
><br>
> The Configuration Reference now shows new, deprecated, and changed options release-over-release with this: <a href="https://review.openstack.org/#/c/97621/">https://review.openstack.org/#/c/97621/</a>. <br>
><br>
> There are three install guide patches for Debian that need review:<br>
><br>
>  <a href="https://review.openstack.org/97158">https://review.openstack.org/97158</a><br>
><br>
>  <a href="https://review.openstack.org/96687">https://review.openstack.org/96687</a><br>
><br>
>  <a href="https://review.openstack.org/98329">https://review.openstack.org/98329</a><br>
><br>
><br>
> 2. High priority doc work:<br>
><br>
> I've gone through blueprints. One blueprint that I want to discuss further is the quality of the Python client docs that are stored with each project-*client repo. Their doc quality is often low, and Tom filed a blueprint to try to address. Originally we added the Python SDK chapter to the User Guide in hopes of alleviating some of this difficulty. <a href="http://docs.openstack.org/user-guide/content/ch_sdk.html">http://docs.openstack.org/user-guide/content/ch_sdk.html</a> </p>

<p dir="ltr">I'm happy to see some good documentation on the python clients. As a follow up to this BP, what about deleting out of date docs in client repos and just did a link to here?</p>
<p dir="ltr">><br>
> Rather than chase quality across nine (integrated) python-*client repos, I'd prefer to spend time to document the common openstack client and common SDKs. However, those are probably six months to a year from widespread use. So is this blueprint a fix for now while we work on the longer term? I'd like more input here to plan a way forward. </p>

<p dir="ltr">The biggest catch here is the common client and none of the SDKs are incubated yet (they don't have a program to live in at the moment). But that should be a fairly easy fix.</p>
<p dir="ltr">><br>
> 3. Doc work going on that I know of:<br>
><br>
> I've approved juno blueprints for:<br>
> -Install Guide improvements <br>
> -Adding Monitoring to the User Guide (or Admin User Guide as needed) <br>
> -Adding a Databases chapter to the User Guide <br>
> -Adding release-to-release change info to config reference <br>
> -Adding Orchestration template reference guide to the User Guide <br>
> -An overarching OpenStack API document is started, Diane has the blueprint.<br>
> -I believe the "deployment-template" blueprint will be fulfilled with the upcoming architecture book sprint.<br>
> -The blueprint for "understanding networking" is still in discussion, and I think we have agreement to start a new Networking Admin Guide. Let me know if you'd like to run point on that -- Karin and Lana have ideas and can probably run with it.<br>

> - Updating to use the ITS tool for doc translation is in discussion with a beta available. I'm good with this work as long as the localization team is interested.<br>
> -Training manuals have a blueprint that they'll move to their own Launchpad location, I believe.<br>
> - I'm working on a redesign for the docs site, still drafting solutions.<br>
><br>
> There are blueprints still lingering:<br>
> -Automation of API samples from the nova repo to the api-site repo - do we still want to do this?<br>
> -Redocument Xen -- I think there is interest, would someone like to be point? John Garbutt or Bob Ball or both?<br>
> -VPNaaS Neutron deployment -- Edgar, is this completed with <a href="http://docs.openstack.org/api/openstack-network/2.0/content/vpnaas_ext.html">http://docs.openstack.org/api/openstack-network/2.0/content/vpnaas_ext.html</a>?<br>

> -Keystone updates - Joe Heck originally wanted to do this one, and we need to document more of v3 from deployers and users standpoint. Any interest?<br>
><br>
> I'll reach out to individuals as well. <br>
><br>
> 4. New incoming doc requests:<br>
><br>
> We've recorded blueprints for incoming doc requests. Thanks for all the good ideas.<br>
><br>
> 5. Doc tools updates:<br>
><br>
> Diane's working on a change to make query parameters show up in the API reference output. You can test it here: <a href="https://review.openstack.org/#/c/99198/">https://review.openstack.org/#/c/99198/</a>. To test the maven clouddocs plugin prior to a release, you checkout a local copy of the patch of the plugin, then run:<br>

> mvn clean install<br>
><br>
> Make a note of what -SNAPSHOT version is built, then change the pom.xml of what you want to build to the newly, locally built SNAPSHOT version. Run:<br>
> mvn -U clean generate-sources <br>
><br>
> The -U parameter forces your local environment to use the SNAPSHOT version. Then look at the local output.<br>
><br>
> Andreas is out this week and next, so I'm hesitant to cut a release of openstack-doc-tools without him. The change that's still pending is the new/changed/deprecated options in the configuration reference.<br>

><br>
> 6. Other doc news:<br>
> The architecture book sprint starts July 7th and goes all week, with a new PDF by July 11th. The week following we'll bring it into docbook and our review process. Thanks to all our hearty authors taking on the challenge!<br>

><br>
> _______________________________________________<br>
> OpenStack-dev mailing list<br>
> <a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
><br>
</p>