<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Feb 13, 2017 at 10:57 PM, Brian Moss <span dir="ltr"><<a href="mailto:kallimachos@gmail.com" target="_blank">kallimachos@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="gmail-">On 14 February 2017 at 13:45, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a><wbr>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><br></div><div class="gmail_extra"><br><div class="gmail_quote"><span class="gmail-m_4524621378167068563gmail-m_3830691061681567074gmail-">On Mon, Feb 13, 2017 at 8:44 PM, Brian Moss <span dir="ltr"><<a href="mailto:kallimachos@gmail.com" target="_blank">kallimachos@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div><div><div><div><div>Hi all,<br><br></div>There is an openstack-doc-tools [1] project in Launchpad. It asks reporters to file bugs in openstack-manuals [2]. The openstackdocstheme project in Launchpad does the same thing [3].<br><br>For the openstackdocstheme project, bug reporting has been disabled. This ensures that reporters will file theme bugs in openstack-manuals.<br><br></div>For the openstack-doc-tools project, bug reporting is still enabled. This means that some tools bugs are reported in openstack-manuals, and some in openstack-doc-tools.<br><br></div>I propose that we migrate the existing bugs in openstack-doc-tools to openstack-manuals, then disable bug reporting in openstack-doc-tools.<br><br></div>Please let me know if you think this is a good/bad idea.<br></div></div></div></blockquote><div><br></div><div><br></div></span>A year ago last month I established the Launchpad bug tracker. [4] The skill set and people could then grow in a focused direction. Plus it allows for less split attention, and the bug numbers in openstack-manuals can accurately reflect docs and content quality, not tool quality.</div><div class="gmail_quote"><br></div><div class="gmail_quote">What is the reasoning for consolidating? I'd like to hear more about your reasons and why bug reporting was disabled for the theme, for example. We could use separate tracking for the logo and web theme changes, for example, so I see the separate tracker as a good way to separate concerns and prioritize without distracting content work.</div><div class="gmail_quote"><br></div></div></div></blockquote><div><br></div></span><div>I actually don't know when or why bugs were disabled for the theme. Maybe someone in the know can chime in?<br><br></div><div>The doc-tools project says "File bugs at <a rel="nofollow" href="https://bugs.launchpad.net/openstack-manuals" target="_blank">https://bugs.launchpad.net/ope<wbr>nstack-manuals</a>" in the description. Consequently there are tools bugs in openstack-manuals. Not everyone reads that message though, so there are also tools bugs in doc-tools. My proposal was based on analogy with openstackdocstheme, which tells reporters to file bugs in openstack-manuals and has disabled bug reporting. In addition, the Contributor Guide currently indicates that doc bugs for openstackdocstheme, openstack-doc-tools, openstack-manuals, and security-doc should be filed in openstack-manuals (<a href="http://docs.openstack.org/contributor-guide/doc-bugs.html" target="_blank">http://docs.openstack.org/con<wbr>tributor-guide/doc-bugs.html</a>), and that tools bugs should be filed in openstack-manuals (<a href="http://docs.openstack.org/contributor-guide/doc-tools/contributing.html#file-a-bug-against-the-tools" target="_blank">http://docs.openstack.org/<wbr>contributor-guide/doc-tools/<wbr>contributing.html#file-a-bug-<wbr>against-the-tools</a>).<br><br></div><div>But I'm quite happy to go the other direction if people would prefer. We could add a note to the openstack-manuals description instructing people to file tools and theme bugs in their respective projects, and then migrate all those bugs out of openstack-manuals. We'd also need to update the contributor guide appropriately.<br><br></div><div>The end goal is making it clear for reporters where they should file bugs, and making it clear for contributors where to look for bugs. On the one hand, it makes sense to keep tools, theme, and content bugs in separate projects to minimize noise. On the other hand, there are benefits to consolidating all the bugs in one place as it gives the theme and tools work more visibility.<br></div><div><br></div></div></div></div></blockquote><div><br></div><div>My thinking was that our goal right now is to reduce the bug count in openstack-manuals, and sorting more precisely helps with that goal, which in reality isn't about the count but about the doc quality.</div><div><br></div><div>So I'm inclined to update: </div><div>- bug reporting in the theme docs</div><div>- wording in the openstack-doc-tools project</div><div>- contributor guide instructions</div><div><br></div><div>That'll keep us going along the top priority, accurate bug counts. Here's a patch for the openstack-doc-tools README.rst: <a href="https://review.openstack.org/434006">https://review.openstack.org/434006</a>.</div><div><br></div><div>Feel free to review there or write back here on the list. Would also like to hear from Andreas -- he was the one who set up the bug tracking in mid-2015, not me, heh.</div><div><br></div><div>Anne </div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div></div><div>Cheers,<br><br></div><div>Brian<br></div><span class="gmail-"><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"></div><div class="gmail_quote">Say more about your idea so I can better evaluate the need.</div><div class="gmail_quote"><br></div><div class="gmail_quote">Anne<br><div><br></div><div>4. <a href="http://lists.openstack.org/pipermail/openstack-docs/2016-January/008192.html" target="_blank">http://lists.openstack.org/pip<wbr>ermail/openstack-docs/2016-Jan<wbr>uary/008192.html</a></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-m_4524621378167068563gmail-m_3830691061681567074gmail-"><div dir="ltr"><div><div><br></div>Cheers,<br><br></div>Brian<br><div><div><div><div><div><div><br>[1] <a href="https://launchpad.net/openstack-doc-tools" target="_blank">https://launchpad.net/openstac<wbr>k-doc-tools</a><br>[2] <a href="https://launchpad.net/openstack-manuals" target="_blank">https://launchpad.net/openstac<wbr>k-manuals</a><br>[3] <a href="https://launchpad.net/openstackdocstheme" target="_blank">https://launchpad.net/openstac<wbr>kdocstheme</a><a rel="nofollow" href="https://bugs.launchpad.net/openstack-manuals" target="_blank"></a></div></div></div></div></div></div></div>
<br></span>______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack<wbr>.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-docs</a><br>
<br></blockquote></div><span class="gmail-m_4524621378167068563gmail-m_3830691061681567074gmail-HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div class="gmail-m_4524621378167068563gmail-m_3830691061681567074gmail-m_5589123569499519068gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><br></div><div>Read my blog: <a href="https://justwriteclick.com" target="_blank">justwrite.click</a></div><div>Subscribe to Docs|Code: <a href="http://docslikecode.com" target="_blank">docslikecode.com</a> </div></div></div></div></div></div></div>
</font></span></div></div>
</blockquote></span></div><br></div></div>
<br>______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><br></div><div>Read my blog: <a href="https://justwriteclick.com" target="_blank">justwrite.click</a></div><div>Subscribe to Docs|Code: <a href="http://docslikecode.com" target="_blank">docslikecode.com</a> </div></div></div></div></div></div></div>
</div></div>