<div dir="ltr">Very good improvement in our documentation process.<div><br></div><div>Is there a way to configure it, so bugs would be created with tag "docs" automatically? It would simplify triaging process I believe.</div><div>From the other hand, as far as I understand, up to 80% of commits with "DocImpact" will impact development documentation (or it's intended to be affecting only user documentation?). It would be hard for tech writers, who are mostly specialized in Fuel user docs, to work on low-level details of how, let's say, l23network [1] works.</div><div>Do we want to separate docs bugs somehow, user/dev? </div><div><br></div><div>In other words, what would be the flow, who becomes responsible for fixing bugs created automatically by Infra?</div><div><br></div><div>[1] <a href="https://github.com/stackforge/fuel-library/tree/master/deployment/puppet/l23network" target="_blank">https://github.com/stackforge/fuel-library/tree/master/deployment/puppet/l23network</a></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Oct 8, 2014 at 5:34 PM, Sergii Golovatiuk <span dir="ltr"><<a href="mailto:sgolovatiuk@mirantis.com" target="_blank">sgolovatiuk@mirantis.com</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 dir="ltr"><div><div><div>Hi,<br><br></div><div>On Fuel Summit '2014 we discussed our Documentation process. According to follow up we aligned it to OpenStack 'DocImpact' process. The new process has been tested on background by me and Bogdan Dobrelya. Today, I have updated <a href="https://wiki.openstack.org/wiki/Fuel/How_to_contribute#Documentation" target="_blank">Fuel Documentation Process</a> so we are making it official. <br><br></div><div>Why?<br>Developer perspective:<br></div><div>It gives more flexibility for the developers to participate in Documentation Process. Every time when the Reviewer sees that patch requires Documentation update, it may ask the Commiter to update 'Commit Message' with DocImpact message. Once patch passes the review Openstack Infra will trigger a new bug in Launchpad that should be assigned to Fuel Documentation team.<br><br></div><div>From Fuel Documentation Team perspective:<br>When Fuel Documentation Team sees this bug they know who was the commiter and reviewers and whom they should add for documentation review.<br><br></div>Community:<br></div>Community member may ask the developer to put 'DocImpact' message when it's required.<br><br></div><div><div><div><div>--<br><div><div><div><div dir="ltr">
Best regards,<br>
Sergii Golovatiuk,<br>
Skype #golserge<br>
IRC #holser<br></div></div>
</div></div></div></div></div></div></div>
<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>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr">Mike Scherbakov<br>#mihgen<br><br></div>
</div></div>