<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Nov 21, 2013 at 1:53 AM, Michael Still <span dir="ltr"><<a href="mailto:mikal@stillhq.com" target="_blank">mikal@stillhq.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="im">On Thu, Nov 21, 2013 at 7:54 AM, Anne Gentle <<a href="mailto:anne@openstack.org">anne@openstack.org</a>> wrote:<br>


<br>
> 5. Doc tools updates:<br>
><br>
> David Cramer tells me he'll cut one more release of the clouddocs-tools<br>
> maven plugin then it'll be put into Gerrit workflow in the OpenStack<br>
> organization. Thanks to David and Zaro for the hard work here over many<br>
> months. I'd encourage Stackers to see how they can get involved in<br>
> collaborating on our doc build tool once it's in our OpenStack systems.<br>
><br>
> Some reps from infra and myself will meet with O'Reilly technical folks on<br>
> Monday to finalize the workflow for the operations-guide repository. Once we<br>
> have it fleshed out I'll communicate it to the openstack-docs list.<br>
<br>
</div>One day in the infinite future when the gate is fixed<br>
<a href="https://review.openstack.org/#/c/56158/" target="_blank">https://review.openstack.org/#/c/56158/</a> and<br>
<a href="https://review.openstack.org/#/c/57332/" target="_blank">https://review.openstack.org/#/c/57332/</a> will merge. This is something<br>
Lana and I cooked up where the script which creates DocImpact bugs has<br>
been tweaked to be able to add subscribers.<br>
<br>
The basic idea is that you define a group of author email addresses<br>
(your team at work perhaps), and then you can assign people to<br>
subscribe to DocImpact bugs created by those people. This will allow<br>
Lana to keep a better track of the DocImpact bugs her co-workers are<br>
creating.<br>
<br></blockquote><div><br></div><div>I really really like this concept and hope to spread the idea to more teams. How can I help get the word out? A couple of ideas:</div><div><br></div><div>- Include in next What's Up Doc?</div>

<div>- Blog post about it that'll go to <a href="http://planet.openstack.org">planet.openstack.org</a></div><div>- Tweet the heck outta those</div><div><br></div><div>Anything else?</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


I'm hoping to trick other development teams into using this feature,<br>
and embedding tech writers into their teams. Frankly, if developers<br>
land features and they're never documented that significantly devalues<br>
the feature. I'm hoping developers will see the value in having a tech<br>
writer work closely with them to get their features documented. Also,<br>
it will hopefully lead to more tech writers being hired by the various<br>
development teams.<br>
<br>
Lana and I will advertise this better once its landed and we've used<br>
it long enough to ensure it works right.<br>
<span class="HOEnZb"><font color="#888888"><br>
Michael<br>
<br>
--<br>
Rackspace Australia<br>
</font></span><div class="HOEnZb"><div class="h5"><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>
</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>