diff --git a/doc/source/policies/bugs.rst b/doc/source/policies/bugs.rst index 04756df7779..6be48eea23c 100644 --- a/doc/source/policies/bugs.rst +++ b/doc/source/policies/bugs.rst @@ -94,14 +94,14 @@ steps you will need to follow in order to be prepared. around setting the importance and tags of bugs. * Sign up for neutron bug emails from LaunchPad. - * Navigate to the `LaunchPad Neutron bug list `_. + * Navigate to the `LaunchPad Neutron bug list `_. * On the right hand side, click on "Subscribe to bug mail". * In the pop-up that is displayed, keep the recipient as "Yourself", and your subscription something useful like "Neutron Bugs". You can choose either option for how much mail you get, but keep in mind that getting mail for all changes - while informative - will result in several dozen emails per day at least. - * Do the same for the `LaunchPad python-neutronclient bug list `_. + * Do the same for the `LaunchPad python-neutronclient bug list `_. * Configure the information you get from `LaunchPad `_ to make visible additional information, especially the 'age' of the bugs. You @@ -247,6 +247,13 @@ The process of bug triaging consists of the following steps: * Check if a bug was filed for a correct component (project). If not, either change the project or mark it as "Invalid". +* For bugs that affect documenation (including autogenerated DocImpact bugs) + proceed like this. If documentation affects + * the ReST API, add "openstack-api-site" to the affected projects. + * the OpenStack manuals, like the Networking Guide or the Configuration + Reference, add "openstack-manuals" to the affected projects + * developer documentation (devref), set the bug to "Confirmed" for + the project Neutron, otherwise set it to "Invalid". * Check if a similar bug was filed before. Rely on your memory if Launchpad is not clever enough to spot a duplicate upon submission. You may also check already verified bugs for `Neutron `_ @@ -270,7 +277,8 @@ If the bug report is sound, move next: * Depending on ease of reproduction (or if the issue can be spotted in the code), mark it as 'Confirmed'. If you are unable to assess/triage the issue because you do not have access to a repro environment, consider - reaching out the Lieutenant, go-to person for the affected component; + reaching out the `Lieutenant `_, + go-to person for the affected component; he/she may be able to help: assign the bug to him/her for further screening. If the bug already has an assignee, check that a patch is in progress. Sometimes more than one patch is required to address an