)]}'
{"doc/contributor-guide/source/docs-builds.rst":[{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":69,"context_line":""},{"line_number":70,"context_line":"     This command does not work for the install-guide, as it"},{"line_number":71,"context_line":"     contains conditional content. To build specific parts of the"},{"line_number":72,"context_line":"     Installation guide, use the commands below:"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"     .. code-block:: console"},{"line_number":75,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_2087ce10","line":72,"range":{"start_line":72,"start_character":18,"end_line":72,"end_character":23},"updated":"2016-07-18 09:40:55.000000000","message":"Installation Guide* (as it is the name of the guide)","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":69,"context_line":""},{"line_number":70,"context_line":"     This command does not work for the install-guide, as it"},{"line_number":71,"context_line":"     contains conditional content. To build specific parts of the"},{"line_number":72,"context_line":"     Installation guide, use the commands below:"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"     .. code-block:: console"},{"line_number":75,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_031d6f73","line":72,"range":{"start_line":72,"start_character":18,"end_line":72,"end_character":23},"in_reply_to":"dada55a8_2087ce10","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":79,"context_line":"        $ tox -e install-guide-rdo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"This runs the :command:`sphinx-build` command. When the build is finished,"},{"line_number":82,"context_line":"it will be displayed in the ``openstack-manuals/publish-docs`` directory."},{"line_number":83,"context_line":"You can open the ``.html`` file in a browser to view the resulting output."},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"If you do not want to use Tox, install the below prerequisites locally:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_c076b23d","line":82,"range":{"start_line":82,"start_character":3,"end_line":82,"end_character":27},"updated":"2016-07-18 09:40:55.000000000","message":"it displays in the*","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":79,"context_line":"        $ tox -e install-guide-rdo"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"This runs the :command:`sphinx-build` command. When the build is finished,"},{"line_number":82,"context_line":"it will be displayed in the ``openstack-manuals/publish-docs`` directory."},{"line_number":83,"context_line":"You can open the ``.html`` file in a browser to view the resulting output."},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"If you do not want to use Tox, install the below prerequisites locally:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_5620c79b","line":82,"range":{"start_line":82,"start_character":3,"end_line":82,"end_character":27},"in_reply_to":"dada55a8_c076b23d","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":97,"context_line":"   $ sphinx-build /path/to/source/ path/to/build/"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"The RST source is built into HTML using Sphinx, so that it is displayed on"},{"line_number":100,"context_line":"the *docs.openstack.org/\u003cguide-name\u003e*, for example,"},{"line_number":101,"context_line":"http://docs.openstack.org/user-guide."},{"line_number":102,"context_line":""},{"line_number":103,"context_line":"The DocBook source is built into HTML (webhelp) and PDF using XSLT transforms"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_60a0a691","line":100,"range":{"start_line":100,"start_character":37,"end_line":100,"end_character":51},"updated":"2016-07-18 09:40:55.000000000","message":"\u003cguide-name\u003e. For example: *","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":97,"context_line":"   $ sphinx-build /path/to/source/ path/to/build/"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"The RST source is built into HTML using Sphinx, so that it is displayed on"},{"line_number":100,"context_line":"the *docs.openstack.org/\u003cguide-name\u003e*, for example,"},{"line_number":101,"context_line":"http://docs.openstack.org/user-guide."},{"line_number":102,"context_line":""},{"line_number":103,"context_line":"The DocBook source is built into HTML (webhelp) and PDF using XSLT transforms"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_96419f3c","line":100,"range":{"start_line":100,"start_character":37,"end_line":100,"end_character":51},"in_reply_to":"dada55a8_60a0a691","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":140,"context_line":"   * If Tox stops working, try :command:`tox --recreate` to rebuild the"},{"line_number":141,"context_line":"     environment."},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"build an existing patch locally"},{"line_number":144,"context_line":"-------------------------------"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"To build a patch locally:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_60c70646","line":143,"range":{"start_line":143,"start_character":0,"end_line":143,"end_character":5},"updated":"2016-07-18 09:40:55.000000000","message":"Build*","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":140,"context_line":"   * If Tox stops working, try :command:`tox --recreate` to rebuild the"},{"line_number":141,"context_line":"     environment."},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"build an existing patch locally"},{"line_number":144,"context_line":"-------------------------------"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"To build a patch locally:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_16748f9a","line":143,"range":{"start_line":143,"start_character":0,"end_line":143,"end_character":5},"in_reply_to":"dada55a8_60c70646","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":145,"context_line":""},{"line_number":146,"context_line":"To build a patch locally:"},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"#. Change to the directory containing the appropriate repository."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":"   .. code-block:: console"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_80d15afe","line":148,"range":{"start_line":148,"start_character":54,"end_line":148,"end_character":65},"updated":"2016-07-18 09:40:55.000000000","message":"repository: * (and for each of the options below too)","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":145,"context_line":""},{"line_number":146,"context_line":"To build a patch locally:"},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"#. Change to the directory containing the appropriate repository."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":"   .. code-block:: console"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_96dd1f73","line":148,"range":{"start_line":148,"start_character":54,"end_line":148,"end_character":65},"in_reply_to":"dada55a8_80d15afe","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9cebdd6bd68c9c7a445acb895c775ef8d44e8fc4","unresolved":false,"context_lines":[{"line_number":157,"context_line":""},{"line_number":158,"context_line":"      $ git review -d PATCH_ID"},{"line_number":159,"context_line":""},{"line_number":160,"context_line":"   Where the value of PATCH_ID is a Gerrit commit number."},{"line_number":161,"context_line":"   You can find this number on the patch link,"},{"line_number":162,"context_line":"   ``https://review.openstack.org/#/c/PATCH_ID``."},{"line_number":163,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_c0db521a","line":160,"range":{"start_line":160,"start_character":22,"end_line":160,"end_character":30},"updated":"2016-07-18 09:40:55.000000000","message":"``PATCH_ID``","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"5a8a001ceb0aa151639927fab9d9eee75a2835d9","unresolved":false,"context_lines":[{"line_number":157,"context_line":""},{"line_number":158,"context_line":"      $ git review -d PATCH_ID"},{"line_number":159,"context_line":""},{"line_number":160,"context_line":"   Where the value of PATCH_ID is a Gerrit commit number."},{"line_number":161,"context_line":"   You can find this number on the patch link,"},{"line_number":162,"context_line":"   ``https://review.openstack.org/#/c/PATCH_ID``."},{"line_number":163,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"dada55a8_56ca87a2","line":160,"range":{"start_line":160,"start_character":22,"end_line":160,"end_character":30},"in_reply_to":"dada55a8_c0db521a","updated":"2016-07-18 11:41:50.000000000","message":"Done","commit_id":"6874f1acf217ceaef5c2d621a73bb3aaa3d17d62"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"de5472f76a94aa2f139013aa05275c1dd6f77f92","unresolved":false,"context_lines":[{"line_number":101,"context_line":"the *docs.openstack.org/\u003cguide-name\u003e*. For example:"},{"line_number":102,"context_line":"http://docs.openstack.org/user-guide/."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"The DocBook source is built into HTML (webhelp) and PDF using XSLT transforms"},{"line_number":105,"context_line":"included to the DocBook project."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"You can find tips how to troubleshoot the build at"},{"line_number":108,"context_line":"`Documentation/Troubleshooting"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_15069c51","line":105,"range":{"start_line":104,"start_character":0,"end_line":105,"end_character":32},"updated":"2016-07-21 08:13:03.000000000","message":"Do we still cover DocBook?","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"6ab106e000f604847b47dd4efe5d3a482e532077","unresolved":false,"context_lines":[{"line_number":101,"context_line":"the *docs.openstack.org/\u003cguide-name\u003e*. For example:"},{"line_number":102,"context_line":"http://docs.openstack.org/user-guide/."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"The DocBook source is built into HTML (webhelp) and PDF using XSLT transforms"},{"line_number":105,"context_line":"included to the DocBook project."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"You can find tips how to troubleshoot the build at"},{"line_number":108,"context_line":"`Documentation/Troubleshooting"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_10d50ae7","line":105,"range":{"start_line":104,"start_character":0,"end_line":105,"end_character":32},"in_reply_to":"dada55a8_15069c51","updated":"2016-07-21 08:26:09.000000000","message":"Done. It is really for DocBook content.","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"de5472f76a94aa2f139013aa05275c1dd6f77f92","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* :command:`tox -e checkniceness` - to run the niceness tests (for example,"},{"line_number":126,"context_line":"  to see extra whitespaces)"},{"line_number":127,"context_line":"* :command:`tox -e checksyntax` - to run syntax checks"},{"line_number":128,"context_line":"* :command:`tox -e checkdeletions` - to check that no deleted files are"},{"line_number":129,"context_line":"  referenced"},{"line_number":130,"context_line":"* :command:`tox -e checklinks` - to check whether all the links work"},{"line_number":131,"context_line":"* :command:`tox -e checklang` - to check all the translated manuals"},{"line_number":132,"context_line":"* :command:`tox -e docs` - to build only RST-sourced manuals"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_d5b5247e","line":129,"range":{"start_line":128,"start_character":1,"end_line":129,"end_character":12},"updated":"2016-07-21 08:13:03.000000000","message":"only relevant for DocBook guides.","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"6ab106e000f604847b47dd4efe5d3a482e532077","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* :command:`tox -e checkniceness` - to run the niceness tests (for example,"},{"line_number":126,"context_line":"  to see extra whitespaces)"},{"line_number":127,"context_line":"* :command:`tox -e checksyntax` - to run syntax checks"},{"line_number":128,"context_line":"* :command:`tox -e checkdeletions` - to check that no deleted files are"},{"line_number":129,"context_line":"  referenced"},{"line_number":130,"context_line":"* :command:`tox -e checklinks` - to check whether all the links work"},{"line_number":131,"context_line":"* :command:`tox -e checklang` - to check all the translated manuals"},{"line_number":132,"context_line":"* :command:`tox -e docs` - to build only RST-sourced manuals"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_d057f2c7","line":129,"range":{"start_line":128,"start_character":1,"end_line":129,"end_character":12},"in_reply_to":"dada55a8_d5b5247e","updated":"2016-07-21 08:26:09.000000000","message":"Done","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"de5472f76a94aa2f139013aa05275c1dd6f77f92","unresolved":false,"context_lines":[{"line_number":127,"context_line":"* :command:`tox -e checksyntax` - to run syntax checks"},{"line_number":128,"context_line":"* :command:`tox -e checkdeletions` - to check that no deleted files are"},{"line_number":129,"context_line":"  referenced"},{"line_number":130,"context_line":"* :command:`tox -e checklinks` - to check whether all the links work"},{"line_number":131,"context_line":"* :command:`tox -e checklang` - to check all the translated manuals"},{"line_number":132,"context_line":"* :command:`tox -e docs` - to build only RST-sourced manuals"},{"line_number":133,"context_line":"* :command:`tox -e checkbuild` - to build all the manuals. This will also"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_55aad419","line":130,"range":{"start_line":130,"start_character":0,"end_line":130,"end_character":68},"updated":"2016-07-21 08:13:03.000000000","message":"Only relevant for DocBook content","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"6ab106e000f604847b47dd4efe5d3a482e532077","unresolved":false,"context_lines":[{"line_number":127,"context_line":"* :command:`tox -e checksyntax` - to run syntax checks"},{"line_number":128,"context_line":"* :command:`tox -e checkdeletions` - to check that no deleted files are"},{"line_number":129,"context_line":"  referenced"},{"line_number":130,"context_line":"* :command:`tox -e checklinks` - to check whether all the links work"},{"line_number":131,"context_line":"* :command:`tox -e checklang` - to check all the translated manuals"},{"line_number":132,"context_line":"* :command:`tox -e docs` - to build only RST-sourced manuals"},{"line_number":133,"context_line":"* :command:`tox -e checkbuild` - to build all the manuals. This will also"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_706446b8","line":130,"range":{"start_line":130,"start_character":0,"end_line":130,"end_character":68},"in_reply_to":"dada55a8_55aad419","updated":"2016-07-21 08:26:09.000000000","message":"Done","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"de5472f76a94aa2f139013aa05275c1dd6f77f92","unresolved":false,"context_lines":[{"line_number":190,"context_line":"(current and previous releases), development happens on the master branch."},{"line_number":191,"context_line":"The continuously released books are only built on the master branch."},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"Gates"},{"line_number":194,"context_line":"~~~~~"},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"Like other projects, the documentation projects use a number of gates that do"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_15621c0a","line":193,"range":{"start_line":193,"start_character":0,"end_line":193,"end_character":5},"updated":"2016-07-21 08:13:03.000000000","message":"Let\u0027S say \"Jobs\" or \"checks\". Gates is wrong usage here.","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"6ab106e000f604847b47dd4efe5d3a482e532077","unresolved":false,"context_lines":[{"line_number":190,"context_line":"(current and previous releases), development happens on the master branch."},{"line_number":191,"context_line":"The continuously released books are only built on the master branch."},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"Gates"},{"line_number":194,"context_line":"~~~~~"},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"Like other projects, the documentation projects use a number of gates that do"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dada55a8_10eb4ae0","line":193,"range":{"start_line":193,"start_character":0,"end_line":193,"end_character":5},"in_reply_to":"dada55a8_15621c0a","updated":"2016-07-21 08:26:09.000000000","message":"Done","commit_id":"45b23d18e8678e1ac8c3d2ab66d829d00b822946"}]}