<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Sep 3, 2013 at 10:14 AM, Thierry Carrez <span dir="ltr"><<a href="mailto:thierry@openstack.org" target="_blank">thierry@openstack.org</a>></span> wrote:<br>


<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div>Anne Gentle wrote:<br>
> Nova is the overall "winner" (cough) with 110 doc bugs followed by<br>
> keystone with 26. 110 doc bugs indicates a serious need.<br>
<br>
</div>Ouch.<br>
<div><br>
> Teams, please follow through on docs and see how you can help.<br>
><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=nova" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=nova</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=keystone" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=keystone</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=neutron" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=neutron</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=swift" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=swift</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=glance" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=glance</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=cinder" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=cinder</a><br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=xen" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bugs/?field.tag=xen</a><br>
<br>
</div>One way to raise awareness would be to crash the project-specific<br>
meetings and attract everyone's attention to those bugs, pasting the<br>
corresponding link. It just takes one doc-team member to be around, and<br>
should be more efficient than filing extra bugtasks or mentioning it on<br>
the release meeting (which is not attended by that many developers<br>
nowadays).<br>
<br>
Then nothing will beat getting personal, identifying the best person and<br>
tracking them down on IRC :) But that takes much more time.<br>
<div><div><br></div></div></blockquote><div><br></div><div>Looking at the ical feed I know it's not possible for one person to be the doc nag if they want to get any other work done in a week as there are now nearly 30 hour-long meetings each week. :) One thought is to identify doc liaisons per project that serve the purpose of bringing docs up at each weekly meeting. <a href="https://wiki.openstack.org/wiki/Documentation/ProjectDocLeads">https://wiki.openstack.org/wiki/Documentation/ProjectDocLeads</a></div>

<div><br></div><div>Honestly, though, my sense is that the biggest difficulty is for devs to step back and look at the big picture of OpenStack and write docs that way. We also need more deployers writing docs for each other, and users writing docs for consuming OpenStack clouds. Ideas on enabling those writers are also welcome. </div>

<div><br></div><div>Anne</div>
<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div>
--<br>
Thierry Carrez (ttx)<br>
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>