)]}'
{"reference/project-testing-interface.rst":[{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"6b65f1eae76d19af7ab11bbf8418820825357708","unresolved":false,"context_lines":[{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Assuming requirements have been properly installed as indicated by"},{"line_number":59,"context_line":"``doc/requirements.txt`` and ``bindep.txt``, the following command should"},{"line_number":60,"context_line":"work with no addiitonal setup and should result in the documentation being"},{"line_number":61,"context_line":"emitted into ``doc/build``."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_3ab469f2","line":60,"range":{"start_line":60,"start_character":16,"end_line":60,"end_character":18},"updated":"2017-10-03 16:05:54.000000000","message":"typo\n\nIf you don\u0027t need to spin another draft we can fix it separately.","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Assuming requirements have been properly installed as indicated by"},{"line_number":59,"context_line":"``doc/requirements.txt`` and ``bindep.txt``, the following command should"},{"line_number":60,"context_line":"work with no addiitonal setup and should result in the documentation being"},{"line_number":61,"context_line":"emitted into ``doc/build``."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_3c453b71","line":60,"range":{"start_line":60,"start_character":16,"end_line":60,"end_character":18},"in_reply_to":"7f515b1d_3ab469f2","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"b2d4679cc717c5eee711d43f687376d64237af54","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"  sphinx-build -b doc/source doc/build"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Language specific instructions supplement these and are in addition to them."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_57227aba","line":65,"range":{"start_line":65,"start_character":15,"end_line":65,"end_character":18},"updated":"2017-10-02 10:04:55.000000000","message":"-b html","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"  sphinx-build -b doc/source doc/build"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Language specific instructions supplement these and are in addition to them."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_9c530f3a","line":65,"range":{"start_line":65,"start_character":15,"end_line":65,"end_character":18},"in_reply_to":"7f515b1d_57227aba","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"6b65f1eae76d19af7ab11bbf8418820825357708","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"  sphinx-build -b doc/source doc/build"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Language specific instructions supplement these and are in addition to them."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_fa925158","line":65,"range":{"start_line":65,"start_character":15,"end_line":65,"end_character":18},"in_reply_to":"7f515b1d_57227aba","updated":"2017-10-03 16:05:54.000000000","message":"We should discuss adding PDF output, too. That\u0027s a bit more complicated, because of the job setup, but I would like at least to see some progress on that before moving ahead with this change.\n\nhttp://lists.openstack.org/pipermail/openstack-dev/2017-September/122925.html","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"  sphinx-build -b doc/source doc/build"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Language specific instructions supplement these and are in addition to them."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_9c28af97","line":65,"range":{"start_line":65,"start_character":15,"end_line":65,"end_character":18},"in_reply_to":"7f515b1d_b42bb780","updated":"2017-10-05 18:17:33.000000000","message":"I agree - let\u0027s figure out the how for PDF and then come back and follow up updating this to add it.","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"45773987724dac37046df217c283bcc88414a074","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":".. code-block:: bash"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"  sphinx-build -b doc/source doc/build"},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Language specific instructions supplement these and are in addition to them."},{"line_number":68,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_b42bb780","line":65,"range":{"start_line":65,"start_character":15,"end_line":65,"end_character":18},"in_reply_to":"7f515b1d_fa925158","updated":"2017-10-04 10:26:41.000000000","message":"PDF build was implemented to openstack-manuals with a spec [1] and now executing a sphinx command with \"-b latex\" option \u0026 make command [2] and configuring conf.py [3] can extend PDF output to all OpenStack documents. \n\nI have been discussing with my colleagues. [4] is current WIP spec with setup.cfg modification, but it seems that there is currently a bug on supporting multiple builders [5]. With sphinx command, we need to separately call \"-b html\" and \"-b latex\" options.\n\n[1] http://specs.openstack.org/openstack/docs-specs/specs/ocata/build-pdf-from-rst-guides.html\n[2] http://git.openstack.org/cgit/openstack/openstack-doc-tools/tree/bin/doc-tools-build-rst#n96\n[3] Number 10 in https://docs.openstack.org/openstackdocstheme/latest/\n[4] https://review.openstack.org/#/c/509297/\n[5] https://github.com/sphinx-doc/sphinx/issues/4111","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"}],"reference/pti/golang.rst":[{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"4244b64b1af83aacfe09ca53a830ce7af6071d69","unresolved":false,"context_lines":[{"line_number":245,"context_line":"OpenStack release tooling uses ``setup.py`` as an interface for the release"},{"line_number":246,"context_line":"process.  It is expected that golang projects will also use ``setup.py`` for"},{"line_number":247,"context_line":"some of its interface to these tools, however it may be desirable to investigate"},{"line_number":248,"context_line":"alternate interfaces if Sphinx docs are the only primary use otherwise."},{"line_number":249,"context_line":""},{"line_number":250,"context_line":"Build Tools"},{"line_number":251,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_694a2184","side":"PARENT","line":248,"updated":"2017-10-03 14:04:19.000000000","message":"good to see this go","commit_id":"26782311632ded7843a78de91547d45cae2eed19"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"b2d4679cc717c5eee711d43f687376d64237af54","unresolved":false,"context_lines":[{"line_number":211,"context_line":"* Either install any needed distro dependencies from the ``doc`` tag in"},{"line_number":212,"context_line":"  ``bindep.txt`` or emit an error if they are not installed."},{"line_number":213,"context_line":"* Install Python dependencies for Sphinx from ``doc/requirements.txt``."},{"line_number":214,"context_line":"* Execute ``sphinx-build -b doc/source doc/build``"},{"line_number":215,"context_line":""},{"line_number":216,"context_line":"Source"},{"line_number":217,"context_line":"~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_17288294","line":214,"range":{"start_line":214,"start_character":25,"end_line":214,"end_character":28},"updated":"2017-10-02 10:04:55.000000000","message":"-b html","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":211,"context_line":"* Either install any needed distro dependencies from the ``doc`` tag in"},{"line_number":212,"context_line":"  ``bindep.txt`` or emit an error if they are not installed."},{"line_number":213,"context_line":"* Install Python dependencies for Sphinx from ``doc/requirements.txt``."},{"line_number":214,"context_line":"* Execute ``sphinx-build -b doc/source doc/build``"},{"line_number":215,"context_line":""},{"line_number":216,"context_line":"Source"},{"line_number":217,"context_line":"~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_3c13fb68","line":214,"range":{"start_line":214,"start_character":25,"end_line":214,"end_character":28},"in_reply_to":"7f515b1d_17288294","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"}],"reference/pti/javascript.rst":[{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"b2d4679cc717c5eee711d43f687376d64237af54","unresolved":false,"context_lines":[{"line_number":149,"context_line":"* Either install any needed distro dependencies from the ``doc`` tag in"},{"line_number":150,"context_line":"  ``bindep.txt`` or emit an error if they are not installed."},{"line_number":151,"context_line":"* Install Python dependencies for Sphinx from ``doc/requirements.txt``."},{"line_number":152,"context_line":"* Execute ``sphinx-build -b doc/source doc/build``"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"The project infrastructure will not use ``npm`` to build the documentation."},{"line_number":155,"context_line":"Therefore it is **STRONGLY** discouraged for people to put additional logic"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_f71cc678","line":152,"range":{"start_line":152,"start_character":25,"end_line":152,"end_character":28},"updated":"2017-10-02 10:04:55.000000000","message":"-b html","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":149,"context_line":"* Either install any needed distro dependencies from the ``doc`` tag in"},{"line_number":150,"context_line":"  ``bindep.txt`` or emit an error if they are not installed."},{"line_number":151,"context_line":"* Install Python dependencies for Sphinx from ``doc/requirements.txt``."},{"line_number":152,"context_line":"* Execute ``sphinx-build -b doc/source doc/build``"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"The project infrastructure will not use ``npm`` to build the documentation."},{"line_number":155,"context_line":"Therefore it is **STRONGLY** discouraged for people to put additional logic"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_1c16ff56","line":152,"range":{"start_line":152,"start_character":25,"end_line":152,"end_character":28},"in_reply_to":"7f515b1d_f71cc678","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"}],"reference/pti/python.rst":[{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"9a1e9b1aab8c025b4bf5f5cddec9e038c0286ecc","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"In addition to the normal PTI :ref:`pti-documentation` requirements, Python"},{"line_number":114,"context_line":"projects should put the following into their setup.cfg so that"},{"line_number":115,"context_line":"  ``python setup.py build_sphinx`` continues to work:"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"::"},{"line_number":118,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_d7366a03","line":115,"updated":"2017-10-02 10:02:48.000000000","message":"Indentation?","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":112,"context_line":""},{"line_number":113,"context_line":"In addition to the normal PTI :ref:`pti-documentation` requirements, Python"},{"line_number":114,"context_line":"projects should put the following into their setup.cfg so that"},{"line_number":115,"context_line":"  ``python setup.py build_sphinx`` continues to work:"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"::"},{"line_number":118,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_9c01cf09","line":115,"in_reply_to":"7f515b1d_d7366a03","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"b2d4679cc717c5eee711d43f687376d64237af54","unresolved":false,"context_lines":[{"line_number":125,"context_line":""},{"line_number":126,"context_line":"As a convenience for developers, it is recommended that projects provide"},{"line_number":127,"context_line":"a ``docs`` environment for tox that will run either"},{"line_number":128,"context_line":"``build_sphinx -b doc/source doc/build`` or ``python setup.py build_sphinx``."},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"The project infrastructure will not use ``tox -edocs`` to build the"},{"line_number":131,"context_line":"documentation. Therefore it is **STRONGLY** discouraged for people to put"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_b712ce60","line":128,"range":{"start_line":128,"start_character":15,"end_line":128,"end_character":18},"updated":"2017-10-02 10:04:55.000000000","message":"ditto","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"d154ffe9ec8f42075472a31b011dad75354d086c","unresolved":false,"context_lines":[{"line_number":125,"context_line":""},{"line_number":126,"context_line":"As a convenience for developers, it is recommended that projects provide"},{"line_number":127,"context_line":"a ``docs`` environment for tox that will run either"},{"line_number":128,"context_line":"``build_sphinx -b doc/source doc/build`` or ``python setup.py build_sphinx``."},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"The project infrastructure will not use ``tox -edocs`` to build the"},{"line_number":131,"context_line":"documentation. Therefore it is **STRONGLY** discouraged for people to put"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f515b1d_df0cd93a","line":128,"range":{"start_line":128,"start_character":15,"end_line":128,"end_character":18},"in_reply_to":"7f515b1d_b712ce60","updated":"2017-10-05 18:17:33.000000000","message":"Done","commit_id":"ec6c92a4fd13b4a62062a3602d79b9708cca2183"}]}