)]}'
{"reference/pti/python.rst":[{"author":{"_account_id":27153,"name":"Nguyen Hai","email":"nguyentrihai93@gmail.com","username":"nguyentrihai"},"change_message_id":"ed5736f461288378b7949225599caac21dbc2e02","unresolved":false,"context_lines":[{"line_number":153,"context_line":""},{"line_number":154,"context_line":"In addition to the normal PTI :ref:`pti-documentation` requirements, as a"},{"line_number":155,"context_line":"convenience for developers, it is recommended that projects provide"},{"line_number":156,"context_line":"a ``docs`` environment for tox that will run "},{"line_number":157,"context_line":""},{"line_number":158,"context_line":".. code-block:: bash"},{"line_number":159,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bf659307_e9ab651a","line":156,"updated":"2018-03-27 05:01:49.000000000","message":"nit","commit_id":"74806da7cd0796ec5d1c61b744118903cdd39fe1"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"211c43995d7a2c9f030db67dc21e9ceff31fbb3a","unresolved":false,"context_lines":[{"line_number":28,"context_line":" - tox -ecover"},{"line_number":29,"context_line":" - python setup.py sdist"},{"line_number":30,"context_line":" - python setup.py bdist_wheel"},{"line_number":31,"context_line":" - tox -edocs"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Projects that are translated should also support:"},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf659307_3583e0ce","line":31,"updated":"2018-03-27 13:44:52.000000000","message":"Is this how the CI system actually runs it? I think the other commands in this list match what CI runs.","commit_id":"535185227aa8bfbf7b2d5bc1c998acf7947c4511"},{"author":{"_account_id":5263,"name":"Jeremy Stanley","display_name":"fungi","email":"fungi@yuggoth.org","username":"fungi","status":"missing, presumed fed"},"change_message_id":"3d8fcab1729c11386b1c8c7ea22572997f2f76e2","unresolved":false,"context_lines":[{"line_number":28,"context_line":" - tox -ecover"},{"line_number":29,"context_line":" - python setup.py sdist"},{"line_number":30,"context_line":" - python setup.py bdist_wheel"},{"line_number":31,"context_line":" - tox -edocs"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Projects that are translated should also support:"},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf659307_4e5fbe0d","line":31,"updated":"2018-03-28 15:40:38.000000000","message":"The documentation includes a _recommendation_ that `tox -e docs` be supported, but the entire point of the change was that we stop implying people in the broader Sphinx ecosystem (including but not limited to Python-based projects) actually use tox to build their documentation. I\u0027m with Doug that if we believe most people familiar with Sphinx are going to expect `sphinx-build -b html doc/source doc/build` to work then we should do our best to socialize this syntax within our community as well so that we have one fewer way to make our practices seem \"different\" vs other communities.","commit_id":"535185227aa8bfbf7b2d5bc1c998acf7947c4511"},{"author":{"_account_id":5263,"name":"Jeremy Stanley","display_name":"fungi","email":"fungi@yuggoth.org","username":"fungi","status":"missing, presumed fed"},"change_message_id":"dc7e13ef77a71c560d355baae21a4baec3cd3cb4","unresolved":false,"context_lines":[{"line_number":28,"context_line":" - tox -ecover"},{"line_number":29,"context_line":" - python setup.py sdist"},{"line_number":30,"context_line":" - python setup.py bdist_wheel"},{"line_number":31,"context_line":" - tox -edocs"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Projects that are translated should also support:"},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf659307_f768da1d","line":31,"updated":"2018-03-28 21:54:05.000000000","message":"Well, the pretense (as I understood it) was that people who do Sphinx builds in the wild are used to having to install it and manage the extensions and related dependencies, rather than relying on tox to do it magically. Whether or not that\u0027s true I don\u0027t really know, but it seemed to be the point of the original change.","commit_id":"535185227aa8bfbf7b2d5bc1c998acf7947c4511"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"2b928de96b541eb936b4717b4145cac368348d33","unresolved":false,"context_lines":[{"line_number":28,"context_line":" - tox -ecover"},{"line_number":29,"context_line":" - python setup.py sdist"},{"line_number":30,"context_line":" - python setup.py bdist_wheel"},{"line_number":31,"context_line":" - tox -edocs"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Projects that are translated should also support:"},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf659307_183cd3bd","line":31,"in_reply_to":"bf659307_3583e0ce","updated":"2018-03-27 13:59:09.000000000","message":"No, this is not the command the CI runs. That is covered by the linked documentation, so for here I thought the better point would be to document what we expected the project to provide so someone new or coming from another project could expect to be able to call \"tox -edocs\" and have that work for them locally.","commit_id":"535185227aa8bfbf7b2d5bc1c998acf7947c4511"},{"author":{"_account_id":11904,"name":"Sean McGinnis","email":"sean.mcginnis@gmail.com","username":"SeanM"},"change_message_id":"10043ebe4d8baf4ab8f43bf844e0a8a0154889e9","unresolved":false,"context_lines":[{"line_number":28,"context_line":" - tox -ecover"},{"line_number":29,"context_line":" - python setup.py sdist"},{"line_number":30,"context_line":" - python setup.py bdist_wheel"},{"line_number":31,"context_line":" - tox -edocs"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Projects that are translated should also support:"},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf659307_5796664e","line":31,"in_reply_to":"bf659307_4e5fbe0d","updated":"2018-03-28 21:39:51.000000000","message":"Updated. Though I am still concerned about this. This now states that you should be able to run the sphinx-build command \"in a clean tree\", but that\u0027s now not entirely accurate as they may need to first install and activate a venv with all the docs dependencies before they can run it. So it\u0027s not really \"clean\" to be able to run the command directly.","commit_id":"535185227aa8bfbf7b2d5bc1c998acf7947c4511"}]}