)]}'
{"doc/contributor-guide/source/doc-bugs.rst":[{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":37,"context_line":"If you are interested in serving as a bug triage liaison, there are several steps"},{"line_number":38,"context_line":"you will need to follow in order to be prepared."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"* Before you begin, to work on documentation bugs, you must join the"},{"line_number":41,"context_line":"  openstack-doc-bugs team on Launchpad. For more information,"},{"line_number":42,"context_line":"  see :ref:`first_timers`."},{"line_number":43,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_718d0a7b","line":40,"range":{"start_line":40,"start_character":0,"end_line":40,"end_character":1},"updated":"2017-02-28 15:06:39.000000000","message":"#. (these are steps).","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":37,"context_line":"If you are interested in serving as a bug triage liaison, there are several steps"},{"line_number":38,"context_line":"you will need to follow in order to be prepared."},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"* Before you begin, to work on documentation bugs, you must join the"},{"line_number":41,"context_line":"  openstack-doc-bugs team on Launchpad. For more information,"},{"line_number":42,"context_line":"  see :ref:`first_timers`."},{"line_number":43,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_51be4600","line":40,"range":{"start_line":40,"start_character":2,"end_line":40,"end_character":20},"updated":"2017-02-28 15:06:39.000000000","message":"can be removed","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":41,"context_line":"  openstack-doc-bugs team on Launchpad. For more information,"},{"line_number":42,"context_line":"  see :ref:`first_timers`."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"* Read this page in full. Keep this document in mind at all times as it describes"},{"line_number":45,"context_line":"  the duties of the liaison and how to triage bugs particularly around setting"},{"line_number":46,"context_line":"  the importance and tags of bugs."},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"* Sign up for openstack-manuals emails from LaunchPad if you have not already."},{"line_number":49,"context_line":"  "}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_775fba0e","line":46,"range":{"start_line":44,"start_character":0,"end_line":46,"end_character":34},"updated":"2017-02-28 15:06:39.000000000","message":"This can be placed as an introductory sentence above.","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":45,"context_line":"  the duties of the liaison and how to triage bugs particularly around setting"},{"line_number":46,"context_line":"  the importance and tags of bugs."},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"* Sign up for openstack-manuals emails from LaunchPad if you have not already."},{"line_number":49,"context_line":"  "},{"line_number":50,"context_line":"  #. Navigate to the LaunchPad openstack-manuals bug list."},{"line_number":51,"context_line":"  #. On the right hand side, click on “Subscribe to bug mail”."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_316f1294","line":48,"range":{"start_line":48,"start_character":77,"end_line":48,"end_character":78},"updated":"2017-02-28 15:06:39.000000000","message":":","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":45,"context_line":"  the duties of the liaison and how to triage bugs particularly around setting"},{"line_number":46,"context_line":"  the importance and tags of bugs."},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"* Sign up for openstack-manuals emails from LaunchPad if you have not already."},{"line_number":49,"context_line":"  "},{"line_number":50,"context_line":"  #. Navigate to the LaunchPad openstack-manuals bug list."},{"line_number":51,"context_line":"  #. On the right hand side, click on “Subscribe to bug mail”."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_f15c9aef","line":48,"range":{"start_line":48,"start_character":50,"end_line":48,"end_character":51},"updated":"2017-02-28 15:06:39.000000000","message":"Launchpad","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":48,"context_line":"* Sign up for openstack-manuals emails from LaunchPad if you have not already."},{"line_number":49,"context_line":"  "},{"line_number":50,"context_line":"  #. Navigate to the LaunchPad openstack-manuals bug list."},{"line_number":51,"context_line":"  #. On the right hand side, click on “Subscribe to bug mail”."},{"line_number":52,"context_line":"  #. In the pop-up that is displayed, keep the recipient as “Yourself”, and"},{"line_number":53,"context_line":"     your subscription something useful like “Docs Bugs”. You can choose either"},{"line_number":54,"context_line":"     option for how much mail you get, but keep in mind that getting mail for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_b13062a0","line":51,"range":{"start_line":51,"start_character":5,"end_line":51,"end_character":37},"updated":"2017-02-28 15:06:39.000000000","message":"Click the rightmost ...","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":48,"context_line":"* Sign up for openstack-manuals emails from LaunchPad if you have not already."},{"line_number":49,"context_line":"  "},{"line_number":50,"context_line":"  #. Navigate to the LaunchPad openstack-manuals bug list."},{"line_number":51,"context_line":"  #. On the right hand side, click on “Subscribe to bug mail”."},{"line_number":52,"context_line":"  #. In the pop-up that is displayed, keep the recipient as “Yourself”, and"},{"line_number":53,"context_line":"     your subscription something useful like “Docs Bugs”. You can choose either"},{"line_number":54,"context_line":"     option for how much mail you get, but keep in mind that getting mail for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_1c3a25ce","line":51,"range":{"start_line":51,"start_character":38,"end_line":51,"end_character":61},"updated":"2017-02-28 15:06:39.000000000","message":"This should be :guilabel:`Subscribe to bug mail` (as in the \"Tracking bugs by tag\" section below)","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":62,"context_line":"  `Bug Triage Team \u003chttps://wiki.openstack.org/wiki/Documentation/SpecialityTeams#Bug_Triage_Team\u003e`_"},{"line_number":63,"context_line":"  page."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"* During your scheduled time as liaison, if it is feasible for your timezone,"},{"line_number":66,"context_line":"  plan on attending the Docs team meeting. That way if you have any CRITICAL or"},{"line_number":67,"context_line":"  HIGH bugs, you can address them with the team."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_5c93bdfa","line":65,"range":{"start_line":65,"start_character":32,"end_line":65,"end_character":39},"updated":"2017-02-28 15:06:39.000000000","message":"a liaison","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":64,"context_line":""},{"line_number":65,"context_line":"* During your scheduled time as liaison, if it is feasible for your timezone,"},{"line_number":66,"context_line":"  plan on attending the Docs team meeting. That way if you have any CRITICAL or"},{"line_number":67,"context_line":"  HIGH bugs, you can address them with the team."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Bug triaging process"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_3192b258","line":67,"range":{"start_line":67,"start_character":21,"end_line":67,"end_character":28},"updated":"2017-02-28 15:06:39.000000000","message":"address or triage?","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":71,"context_line":""},{"line_number":72,"context_line":"The process of bug triaging consists of the following steps:"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"* Check if a bug was filed for a correct component (project). If not,"},{"line_number":75,"context_line":"  either change the project or mark it as “Invalid”."},{"line_number":76,"context_line":"  For example, if the bug impacts the project-specific dev-ref, then"},{"line_number":77,"context_line":"  mark as \"Invalid\"."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_d18156fd","line":74,"range":{"start_line":74,"start_character":0,"end_line":74,"end_character":1},"updated":"2017-02-28 15:06:39.000000000","message":"#.","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  For example, if the bug impacts the project-specific dev-ref, then"},{"line_number":77,"context_line":"  mark as \"Invalid\"."},{"line_number":78,"context_line":"  "},{"line_number":79,"context_line":"* If documentation affects the ReST API, tools, openstackdocstheme, or"},{"line_number":80,"context_line":"  the Security Guide, add the relevant project to the affected"},{"line_number":81,"context_line":"  projects and remove \"openstack-manuals\"."},{"line_number":82,"context_line":"  For example, if the bug affects the ReST API, file a bug in"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_31c71247","line":79,"range":{"start_line":79,"start_character":5,"end_line":79,"end_character":18},"updated":"2017-02-28 15:06:39.000000000","message":"the bug?","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":86,"context_line":"  remove “neutron” from the affected projects if it only affects"},{"line_number":87,"context_line":"  “openstack-manuals” and tag \"networking-guide\"."},{"line_number":88,"context_line":"  "},{"line_number":89,"context_line":"* Set the bug to “Invalid” if it is a request for support or troubleshooting"},{"line_number":90,"context_line":"  request."},{"line_number":91,"context_line":"  "},{"line_number":92,"context_line":"* Check if a similar bug was filed before. Rely on your memory if Launchpad is"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_71d8aa1e","line":89,"range":{"start_line":89,"start_character":61,"end_line":89,"end_character":76},"updated":"2017-02-28 15:06:39.000000000","message":"a troubleshooting","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":89,"context_line":"* Set the bug to “Invalid” if it is a request for support or troubleshooting"},{"line_number":90,"context_line":"  request."},{"line_number":91,"context_line":"  "},{"line_number":92,"context_line":"* Check if a similar bug was filed before. Rely on your memory if Launchpad is"},{"line_number":93,"context_line":"  not clever enough to spot a duplicate upon submission. You may also check"},{"line_number":94,"context_line":"  already verified bugs to see if the bug has been reported. If so, mark it as"},{"line_number":95,"context_line":"  a duplicate of the previous bug."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_11268e16","line":92,"range":{"start_line":92,"start_character":43,"end_line":92,"end_character":62},"updated":"2017-02-28 15:06:39.000000000","message":"I\u0027m not sure this is possible when there are different bug triage liaisons each 2 weeks.","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":89,"context_line":"* Set the bug to “Invalid” if it is a request for support or troubleshooting"},{"line_number":90,"context_line":"  request."},{"line_number":91,"context_line":"  "},{"line_number":92,"context_line":"* Check if a similar bug was filed before. Rely on your memory if Launchpad is"},{"line_number":93,"context_line":"  not clever enough to spot a duplicate upon submission. You may also check"},{"line_number":94,"context_line":"  already verified bugs to see if the bug has been reported. If so, mark it as"},{"line_number":95,"context_line":"  a duplicate of the previous bug."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_512006f8","line":92,"range":{"start_line":92,"start_character":2,"end_line":92,"end_character":7},"updated":"2017-02-28 15:06:39.000000000","message":"Verify","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":94,"context_line":"  already verified bugs to see if the bug has been reported. If so, mark it as"},{"line_number":95,"context_line":"  a duplicate of the previous bug."},{"line_number":96,"context_line":"  "},{"line_number":97,"context_line":"* Check if the bug meets the requirements of a good bug report, by checking"},{"line_number":98,"context_line":"  that the guidelines or checklist has been followed."},{"line_number":99,"context_line":"  "},{"line_number":100,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_b17dc2e9","line":97,"range":{"start_line":97,"start_character":2,"end_line":97,"end_character":7},"updated":"2017-02-28 15:06:39.000000000","message":"Verify","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":94,"context_line":"  already verified bugs to see if the bug has been reported. If so, mark it as"},{"line_number":95,"context_line":"  a duplicate of the previous bug."},{"line_number":96,"context_line":"  "},{"line_number":97,"context_line":"* Check if the bug meets the requirements of a good bug report, by checking"},{"line_number":98,"context_line":"  that the guidelines or checklist has been followed."},{"line_number":99,"context_line":"  "},{"line_number":100,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_51772602","line":97,"range":{"start_line":97,"start_character":62,"end_line":97,"end_character":63},"updated":"2017-02-28 15:06:39.000000000","message":"no comma","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":103,"context_line":"  the submitter to this document and hope they turn around quickly with the"},{"line_number":104,"context_line":"  missing information."},{"line_number":105,"context_line":""},{"line_number":106,"context_line":".. important:"},{"line_number":107,"context_line":"   "},{"line_number":108,"context_line":"   Do not work on a documentation bug until it is set to"},{"line_number":109,"context_line":"   `Confirmed`. Ideally, another person has to confirm the bug for you. Once the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_b1678224","line":106,"range":{"start_line":106,"start_character":0,"end_line":106,"end_character":13},"updated":"2017-02-28 15:06:39.000000000","message":"This note would better fit to a section like \"Working on doc bugs\".","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":106,"context_line":".. important:"},{"line_number":107,"context_line":"   "},{"line_number":108,"context_line":"   Do not work on a documentation bug until it is set to"},{"line_number":109,"context_line":"   `Confirmed`. Ideally, another person has to confirm the bug for you. Once the"},{"line_number":110,"context_line":"   changes are made in a patch, they are reviewed and approved, just like other"},{"line_number":111,"context_line":"   OpenStack code."},{"line_number":112,"context_line":"   "}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_11020e3f","line":109,"range":{"start_line":109,"start_character":3,"end_line":109,"end_character":4},"updated":"2017-02-28 15:06:39.000000000","message":"it\u0027s ‘ on line 102","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":114,"context_line":"   go to `the aggregated list of documentation bugs from all OpenStack projects"},{"line_number":115,"context_line":"   \u003chttps://bugs.launchpad.net/openstack/+bugs?field.tag\u003ddocumentation\u003e`_."},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"Follow the guidelines below for more information on statues, importance,"},{"line_number":118,"context_line":"and assigning."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Doc bug triaging guidelines"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_3cad2932","line":117,"range":{"start_line":117,"start_character":56,"end_line":117,"end_character":57},"updated":"2017-02-28 15:06:39.000000000","message":"statuses :)","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"f8bd61b77b9c83d21e0c044b70c0f8feac5c8469","unresolved":false,"context_lines":[{"line_number":186,"context_line":"of the launchpad project"},{"line_number":187,"context_line":"\u003chttps://bugs.launchpad.net/openstack-manuals/+subscriptions\u003e`_:"},{"line_number":188,"context_line":""},{"line_number":189,"context_line":"1. Select :guilabel:`Add a subscription`."},{"line_number":190,"context_line":"2. Select the option to receive mail for bugs affecting the project"},{"line_number":191,"context_line":"   that :guilabel:`are added or changed in any way`."},{"line_number":192,"context_line":"3. Check the :guilabel:`Bugs must match this filter` checkbox."}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba2be162_51580657","line":189,"range":{"start_line":189,"start_character":0,"end_line":189,"end_character":2},"updated":"2017-02-28 15:06:39.000000000","message":"#.","commit_id":"71e91e03d02dcb3a557f7624637e36f4e4ebda37"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"5a3e6b7e36f78714f2facf29a3f6f3fd4aca2c59","unresolved":false,"context_lines":[{"line_number":248,"context_line":"OpenStack projects"},{"line_number":249,"context_line":"\u003chttps://bugs.launchpad.net/openstack/+bugs?field.tag\u003ddocumentation\u003e`_."},{"line_number":250,"context_line":""},{"line_number":251,"context_line":"Follow the guidelines below for more information on statuses, importance,"},{"line_number":252,"context_line":"and assigning."}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba2be162_a89ab0c3","line":252,"range":{"start_line":251,"start_character":0,"end_line":252,"end_character":14},"updated":"2017-02-28 16:49:30.000000000","message":"This can be removed/rephrased as there are no guidelines below.","commit_id":"1684937ee1fbc929e5d6091b57b18a39ffd1dd02"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"9f4e4812fbb18b15495fd0f0e00de83a81095bb9","unresolved":false,"context_lines":[{"line_number":40,"context_line":".. note::"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"   Read this page in full. Keep this document in mind at all times as it"},{"line_number":43,"context_line":"   describes the duties of the liaison and how to triage bugs particularly"},{"line_number":44,"context_line":"   around setting the importance and tags of bugs."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"#. Before you begin, to work on documentation bugs, you must join the"}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_0d6015ce","line":43,"updated":"2017-03-01 06:16:30.000000000","message":"Start a new sentence here - \"..duties of the liaison and how to triage bugs. In particular, it describes how to set bug importance, and how to select bug tags.\"","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"9f4e4812fbb18b15495fd0f0e00de83a81095bb9","unresolved":false,"context_lines":[{"line_number":52,"context_line":"   #. Navigate to the Launchpad openstack-manuals bug list."},{"line_number":53,"context_line":"   #. Click on the right hand side, :guilabel:`Subscribe to bug mail`."},{"line_number":54,"context_line":"   #. In the pop-up that is displayed, keep the recipient as “Yourself”, and"},{"line_number":55,"context_line":"      your subscription something useful like “Docs Bugs”. You can choose"},{"line_number":56,"context_line":"      either option for how much mail you get, but keep in mind that getting"},{"line_number":57,"context_line":"      mail for all changes - while informative - will result in several dozen"},{"line_number":58,"context_line":"      emails per day at least."}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_8dcfa5af","line":55,"updated":"2017-03-01 06:16:30.000000000","message":"Add \"name\" into the sentence here - \", and name your subscription something useful..\"","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":74,"context_line":"The process of bug triaging consists of the following steps:"},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"* Check if a bug was filed for a correct component (project). If not,"},{"line_number":77,"context_line":"  either change the project or mark it as “Invalid”."},{"line_number":78,"context_line":"  For example, if the bug impacts the project-specific dev-ref, then"},{"line_number":79,"context_line":"  mark as \"Invalid\"."},{"line_number":80,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_6620d54a","line":77,"range":{"start_line":77,"start_character":42,"end_line":77,"end_character":51},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":82,"context_line":"  the Security Guide, add the relevant project to the affected"},{"line_number":83,"context_line":"  projects and remove \"openstack-manuals\"."},{"line_number":84,"context_line":"  For example, if the bug affects the ReST API, file a bug in"},{"line_number":85,"context_line":"  “openstack-api-site” and remove \"openstack-manuals\"."},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"* Tag the bug for the appropriate guide. For example, for the"},{"line_number":88,"context_line":"  “networking-guide” remove “neutron” from the affected projects if it"}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_a61acd15","line":85,"range":{"start_line":85,"start_character":2,"end_line":85,"end_character":22},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":85,"context_line":"  “openstack-api-site” and remove \"openstack-manuals\"."},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"* Tag the bug for the appropriate guide. For example, for the"},{"line_number":88,"context_line":"  “networking-guide” remove “neutron” from the affected projects if it"},{"line_number":89,"context_line":"  only affects “openstack-manuals” and tag \"networking-guide\"."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"* Set the bug to “Invalid” if it is a request for support or a troubleshooting"}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_c617c1eb","line":88,"range":{"start_line":88,"start_character":2,"end_line":88,"end_character":37},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":86,"context_line":""},{"line_number":87,"context_line":"* Tag the bug for the appropriate guide. For example, for the"},{"line_number":88,"context_line":"  “networking-guide” remove “neutron” from the affected projects if it"},{"line_number":89,"context_line":"  only affects “openstack-manuals” and tag \"networking-guide\"."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"* Set the bug to “Invalid” if it is a request for support or a troubleshooting"},{"line_number":92,"context_line":"  request."}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_e6d20534","line":89,"range":{"start_line":89,"start_character":15,"end_line":89,"end_character":34},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":88,"context_line":"  “networking-guide” remove “neutron” from the affected projects if it"},{"line_number":89,"context_line":"  only affects “openstack-manuals” and tag \"networking-guide\"."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"* Set the bug to “Invalid” if it is a request for support or a troubleshooting"},{"line_number":92,"context_line":"  request."},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"* Check if a similar bug was filed before. You may also check"}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_06d8f952","line":91,"range":{"start_line":91,"start_character":17,"end_line":91,"end_character":26},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":99,"context_line":"  that the guidelines or checklist has been followed."},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"},{"line_number":102,"context_line":"  judgement and your experience and consult another core member/PTL if in"},{"line_number":103,"context_line":"  doubt. If the bug report requires more context, mark the bug as ‘Incomplete’,"},{"line_number":104,"context_line":"  point the submitter to this document and hope they turn around quickly with"},{"line_number":105,"context_line":"  the missing information."}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_667c5521","line":102,"range":{"start_line":102,"start_character":2,"end_line":102,"end_character":11},"updated":"2017-03-01 04:00:29.000000000","message":"judgment","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":99,"context_line":"  that the guidelines or checklist has been followed."},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"},{"line_number":102,"context_line":"  judgement and your experience and consult another core member/PTL if in"},{"line_number":103,"context_line":"  doubt. If the bug report requires more context, mark the bug as ‘Incomplete’,"},{"line_number":104,"context_line":"  point the submitter to this document and hope they turn around quickly with"},{"line_number":105,"context_line":"  the missing information."}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_a6764d3c","line":102,"range":{"start_line":102,"start_character":63,"end_line":102,"end_character":64},"updated":"2017-03-01 04:00:29.000000000","message":"or the","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":100,"context_line":""},{"line_number":101,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"},{"line_number":102,"context_line":"  judgement and your experience and consult another core member/PTL if in"},{"line_number":103,"context_line":"  doubt. If the bug report requires more context, mark the bug as ‘Incomplete’,"},{"line_number":104,"context_line":"  point the submitter to this document and hope they turn around quickly with"},{"line_number":105,"context_line":"  the missing information."},{"line_number":106,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_e68e8526","line":103,"range":{"start_line":103,"start_character":66,"end_line":103,"end_character":78},"updated":"2017-03-01 04:00:29.000000000","message":"smart quotes","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":101,"context_line":"* Omitted information is still acceptable if the issue is clear. Use your good"},{"line_number":102,"context_line":"  judgement and your experience and consult another core member/PTL if in"},{"line_number":103,"context_line":"  doubt. If the bug report requires more context, mark the bug as ‘Incomplete’,"},{"line_number":104,"context_line":"  point the submitter to this document and hope they turn around quickly with"},{"line_number":105,"context_line":"  the missing information."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":".. _guidelines:"},{"line_number":108,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_06947935","line":105,"range":{"start_line":104,"start_character":43,"end_line":105,"end_character":26},"updated":"2017-03-01 04:00:29.000000000","message":"delete","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"86b49657bd077f6565939f51fb52ab6b942e2e15","unresolved":false,"context_lines":[{"line_number":239,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":240,"context_line":""},{"line_number":241,"context_line":"Do not work on a documentation bug until it is set to"},{"line_number":242,"context_line":"\u0027Confirmed\u0027. Ideally, another person has to confirm the bug for you."},{"line_number":243,"context_line":"Once the changes are made in a patch, they are reviewed and approved,"},{"line_number":244,"context_line":"just like other OpenStack code."},{"line_number":245,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"ba2be162_66a3759f","line":242,"range":{"start_line":242,"start_character":22,"end_line":242,"end_character":43},"updated":"2017-03-01 04:00:29.000000000","message":"someone other than the reporter will","commit_id":"4dc1bafee673741818edc6192c242a8a5b618d0e"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"b4f1022ad989dc3cac54a86ba5b7541b946b0e1d","unresolved":false,"context_lines":[{"line_number":31,"context_line":"Bug triage liaison"},{"line_number":32,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"The documentation team uses bug triage liaisons to ensure all bugs reported"},{"line_number":35,"context_line":"against OpenStack manuals are triaged in a timely manner."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"If you are interested in serving as a bug triage liaison, there are several"}],"source_content_type":"text/x-rst","patch_set":11,"id":"ba2be162_55b6078b","line":34,"range":{"start_line":34,"start_character":23,"end_line":34,"end_character":27},"updated":"2017-03-01 11:24:56.000000000","message":"sounds like slavery \u003d)\nCan we replace it with assign or define?","commit_id":"aad13587e9306beb5993daca9c7b32859fe9ac30"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"b4f1022ad989dc3cac54a86ba5b7541b946b0e1d","unresolved":false,"context_lines":[{"line_number":43,"context_line":"   describes the duties of the liaison and how to triage bugs. In particular,"},{"line_number":44,"context_line":"   it describes how to set bug importance, and how to select bug tags."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"#. Before you begin, to work on documentation bugs, you must join the"},{"line_number":47,"context_line":"   openstack-doc-bugs team on Launchpad. For more information,"},{"line_number":48,"context_line":"   see :ref:`first_timers`."},{"line_number":49,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"ba2be162_154acf83","line":46,"range":{"start_line":46,"start_character":19,"end_line":46,"end_character":20},"updated":"2017-03-01 11:24:56.000000000","message":"remove","commit_id":"aad13587e9306beb5993daca9c7b32859fe9ac30"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"b4f1022ad989dc3cac54a86ba5b7541b946b0e1d","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"   #. Navigate to the Launchpad openstack-manuals bug list."},{"line_number":53,"context_line":"   #. Click on the right hand side, :guilabel:`Subscribe to bug mail`."},{"line_number":54,"context_line":"   #. In the pop-up that is displayed, keep the recipient as “Yourself”, and"},{"line_number":55,"context_line":"      name your subscription something useful like “Docs Bugs”. You can choose"},{"line_number":56,"context_line":"      either option for how much mail you get, but keep in mind that getting"},{"line_number":57,"context_line":"      mail for all changes - while informative - will result in several dozen"}],"source_content_type":"text/x-rst","patch_set":11,"id":"ba2be162_b522e3b7","line":54,"range":{"start_line":54,"start_character":61,"end_line":54,"end_character":71},"updated":"2017-03-01 11:24:56.000000000","message":":guilabel:`Yourself`","commit_id":"aad13587e9306beb5993daca9c7b32859fe9ac30"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"b4f1022ad989dc3cac54a86ba5b7541b946b0e1d","unresolved":false,"context_lines":[{"line_number":52,"context_line":"   #. Navigate to the Launchpad openstack-manuals bug list."},{"line_number":53,"context_line":"   #. Click on the right hand side, :guilabel:`Subscribe to bug mail`."},{"line_number":54,"context_line":"   #. In the pop-up that is displayed, keep the recipient as “Yourself”, and"},{"line_number":55,"context_line":"      name your subscription something useful like “Docs Bugs”. You can choose"},{"line_number":56,"context_line":"      either option for how much mail you get, but keep in mind that getting"},{"line_number":57,"context_line":"      mail for all changes - while informative - will result in several dozen"},{"line_number":58,"context_line":"      emails per day at least."}],"source_content_type":"text/x-rst","patch_set":11,"id":"ba2be162_f52c5bad","line":55,"range":{"start_line":55,"start_character":51,"end_line":55,"end_character":62},"updated":"2017-03-01 11:24:56.000000000","message":"guilabel","commit_id":"aad13587e9306beb5993daca9c7b32859fe9ac30"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"b4f1022ad989dc3cac54a86ba5b7541b946b0e1d","unresolved":false,"context_lines":[{"line_number":76,"context_line":"* Check if a bug was filed for a correct component (project). If not,"},{"line_number":77,"context_line":"  either change the project or mark it as ``Invalid``."},{"line_number":78,"context_line":"  For example, if the bug impacts the project-specific dev-ref, then"},{"line_number":79,"context_line":"  mark as ``Invalid``."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* If the reported bug affects the ReST API, tools, openstackdocstheme, or"},{"line_number":82,"context_line":"  the Security Guide, add the relevant project to the affected"}],"source_content_type":"text/x-rst","patch_set":11,"id":"ba2be162_d034c5df","line":79,"range":{"start_line":79,"start_character":2,"end_line":79,"end_character":7},"updated":"2017-03-01 11:24:56.000000000","message":"mark it?","commit_id":"aad13587e9306beb5993daca9c7b32859fe9ac30"}]}