<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, Apr 6, 2014 at 1:40 PM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="">----- Original Message -----<br>
><br>
> Anne,<br>
><br>
> From my understanding, Trove is due to graduate in the Juno release.<br>
><br>
> Is documentation for developers, operators and users not one of the criteria<br>
> (<a href="http://git.openstack.org/cgit/openstack/governance/tree/reference/incubation-integration-requirements" target="_blank">http://git.openstack.org/cgit/openstack/governance/tree/reference/incubation-integration-requirements</a>)<br>


> ?<br>
><br>
><br>
> * Documentation / User support<br>
> ** Project must have end-user docs such as API use, CLI use, Dashboard use<br>
> ** Project should have installation docs providing install/deployment in an<br>
>    integrated manner similar to other OpenStack projects, including<br>
>    configuration reference information for all options<br>
> ** Project should have a proven history of providing user support (on the<br>
>    openstack@ mailing list and on Ask OpenStack)<br>
><br>
><br>
><br>
> If this is not provided in time for the Juno release on<br>
</div>> <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a><<a href="http://docs.openstack.org" target="_blank">http://docs.openstack.org</a>>, does that mean that the<br>
<div class="">> graduation status is delayed until K ?<br>
><br>
> Tim<br>
<br>
</div>There seems to be a bit of a chicken and egg problem here, in that documentation isn't typically accepted into openstack-manuals until the relevant project is officially moved to integrated by the TC. </blockquote>

<div><br></div><div>Yes, we have several issues to work through. A few off the top of my head:</div><div><br>- The OpenStack community needs project teams to scale their doc efforts towards end users and deployers.</div>
<div>
- Trove is the first project being placed in the scrutiny of the new integration graduation requirements. Heat and Ceilometer were integrated prior to these requirements being outlined.</div><div>- The core docs team has not "signed up" for non-core projects based on our mission statement.</div>

<div>- Probably other issues I'm forgetting but please fill them in. :)</div><div><br></div><div>It's a tough problem to unknot for sure, we all need to work towards what we want here and what it's going to take to get what we all want. </div>

<div>Thanks,</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">As a result there's a limited amount of time to integrate any documentation the project is carrying separately into the formal guides.<br>


<br>
Specifically speaking of Trove some of the low hanging fruit is done:<br>
<br>
* Configuration Reference: <a href="http://docs.openstack.org/trunk/config-reference/content/ch_configuring-trove.html" target="_blank">http://docs.openstack.org/trunk/config-reference/content/ch_configuring-trove.html</a><br>


* Command Line Reference: <a href="http://docs.openstack.org/cli-reference/content/troveclient_commands.html" target="_blank">http://docs.openstack.org/cli-reference/content/troveclient_commands.html</a><br>
<br>
But by my reckoning that means we're still missing coverage of the following content in the official documentation project:<br>
<br>
* trove coverage in the installation guide ("Add the X module" - similar to what we have for Orchestration and Telemetry)<br>
* end user documentation<br>
* API documentation<br>
<br>
Thanks,<br>
<br>
Steve<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br></div></div>