)]}'
{"specs/pike/document-tools.rst":[{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"223f5f2f775e0df64ae88b7570872775abb69c65","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":1,"id":"bff0334d_e20b5821","updated":"2017-04-10 09:33:39.000000000","message":"For clarification purposes, can someone explain to my (a) why the \u0027openstack-doc-tools\u0027 project was split out of the \u0027openstack-manuals\u0027 project in the first place and (b) why a spec would be needed for doc changes (particularly if no new guide is being added)? I\u0027m just curious, is all :)","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9c1a5155acfaad836281fc4b60dc228d91363141","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Proposed change"},{"line_number":28,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Update and complete the documentation for ``openstack-doc-tools`` and"},{"line_number":31,"context_line":"``openstackdocstheme``, and consolidate it into a new **OpenStack Documentation"},{"line_number":32,"context_line":"Tools Guide**. Add appropriate links to the new guide from the **OpenStack"},{"line_number":33,"context_line":"Documentation Contributor Guide** and the repository README files."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_45ea43ac","line":33,"range":{"start_line":30,"start_character":0,"end_line":33,"end_character":66},"updated":"2017-04-07 09:40:05.000000000","message":"I like this tbh","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"3be1b6f11499ce744eff5e23577c02b7132d1238","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_b016f6f0","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":22},"updated":"2017-04-07 05:17:41.000000000","message":"I\u0027d like to use this alternative.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":12686,"name":"Brian Moss","email":"kallimachos@gmail.com","username":"bmoss"},"change_message_id":"eb7d633d0bad1941af5150dafc64a833b1c2ea22","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_34cc1369","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":22},"in_reply_to":"bff0334d_19038d75","updated":"2017-04-07 08:34:24.000000000","message":"Cool, that makes things easy. I\u0027ll rework the spec next week with this option as the proposed change. In the meantime, other people can comment if they have a preference.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5f58e15e4e962e2c002d15ec483c308d505a12a5","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_ad5afc26","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":22},"in_reply_to":"bff0334d_34cc1369","updated":"2017-04-07 22:24:56.000000000","message":"Yeah, I would prefer lots of how-tos in the Doc contributors guide, ideally still de-duplicating content.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"92bad941b8c1dacf726781a458f0d377087b05b4","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_d3f3c49d","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":22},"in_reply_to":"bff0334d_b016f6f0","updated":"2017-04-07 06:05:51.000000000","message":"I agree, no need for separate guide (yet).","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"074a07468079646ee847136f40cc43b09cf5992f","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatives"},{"line_number":36,"context_line":"------------"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_19038d75","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":22},"in_reply_to":"bff0334d_d3f3c49d","updated":"2017-04-07 06:55:40.000000000","message":"+1","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"92bad941b8c1dacf726781a458f0d377087b05b4","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"},{"line_number":43,"context_line":"   ``openstack-doc-tools`` repository already has a Sphinx documentation"},{"line_number":44,"context_line":"   project, but it mainly links to various README files and it is not published"},{"line_number":45,"context_line":"   anywhere. ``openstackdocstheme`` also has a Sphinx documentation project"},{"line_number":46,"context_line":"   that provides sample content for theme testing. This approach offers the"},{"line_number":47,"context_line":"   benefit of using Sphinx extensions like auto-doc, but requires a location"},{"line_number":48,"context_line":"   for publishing."},{"line_number":49,"context_line":"-  Maintain the status quo (do nothing)"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_932bfce9","line":48,"range":{"start_line":40,"start_character":0,"end_line":48,"end_character":18},"updated":"2017-04-07 06:05:51.000000000","message":"We can easily publish these to docs.openstack.org/developer/$REPO - like any other OpenStack project.\n\nand then the contributor guide only links to the pages above.\n\nEspecially if we are going to use the openstackdocstheme *everywhere* (see Anne\u0027s spec), then it should have it\u0027s own page.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"b23d6984d37128203c49d995a227aaebfe31cdec","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"},{"line_number":43,"context_line":"   ``openstack-doc-tools`` repository already has a Sphinx documentation"},{"line_number":44,"context_line":"   project, but it mainly links to various README files and it is not published"},{"line_number":45,"context_line":"   anywhere. ``openstackdocstheme`` also has a Sphinx documentation project"},{"line_number":46,"context_line":"   that provides sample content for theme testing. This approach offers the"},{"line_number":47,"context_line":"   benefit of using Sphinx extensions like auto-doc, but requires a location"},{"line_number":48,"context_line":"   for publishing."},{"line_number":49,"context_line":"-  Maintain the status quo (do nothing)"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_0aaa0ad1","line":48,"range":{"start_line":40,"start_character":0,"end_line":48,"end_character":18},"in_reply_to":"bff0334d_54031774","updated":"2017-04-07 09:07:54.000000000","message":"For openstack-doc-tools, we\u0027re the only user - so both would work.\n\nIf there were more users for the tools, I would push for docs.o.o/developer - and a link from  Contributor guide.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5f58e15e4e962e2c002d15ec483c308d505a12a5","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"},{"line_number":43,"context_line":"   ``openstack-doc-tools`` repository already has a Sphinx documentation"},{"line_number":44,"context_line":"   project, but it mainly links to various README files and it is not published"},{"line_number":45,"context_line":"   anywhere. ``openstackdocstheme`` also has a Sphinx documentation project"},{"line_number":46,"context_line":"   that provides sample content for theme testing. This approach offers the"},{"line_number":47,"context_line":"   benefit of using Sphinx extensions like auto-doc, but requires a location"},{"line_number":48,"context_line":"   for publishing."},{"line_number":49,"context_line":"-  Maintain the status quo (do nothing)"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_6d3cf4be","line":48,"range":{"start_line":40,"start_character":0,"end_line":48,"end_character":18},"in_reply_to":"bff0334d_54031774","updated":"2017-04-07 22:24:56.000000000","message":"I think the theme can have its own /developer/$REPO document, sure.\n\nDoc tools content makes sense in the contributor guide as \"here\u0027s how you do this doc task.\"\n\nThat said, agree with Andreas there are few contributors to the doc tools -- but disagree that there are few users, we get questions on the config ref all the time and would be nice to have a single pointer/URL to send people to.","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"},{"author":{"_account_id":12686,"name":"Brian Moss","email":"kallimachos@gmail.com","username":"bmoss"},"change_message_id":"eb7d633d0bad1941af5150dafc64a833b1c2ea22","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"-  Consolidate the content into the existing **OpenStack Documentation"},{"line_number":39,"context_line":"   Contributor Guide**"},{"line_number":40,"context_line":"-  Create Sphinx documentation projects within the ``openstack-doc-tools`` and"},{"line_number":41,"context_line":"   ``openstackdocstheme`` repositories, consolidate the content there, and"},{"line_number":42,"context_line":"   publish the guides somewhere appropriate. Note that the"},{"line_number":43,"context_line":"   ``openstack-doc-tools`` repository already has a Sphinx documentation"},{"line_number":44,"context_line":"   project, but it mainly links to various README files and it is not published"},{"line_number":45,"context_line":"   anywhere. ``openstackdocstheme`` also has a Sphinx documentation project"},{"line_number":46,"context_line":"   that provides sample content for theme testing. This approach offers the"},{"line_number":47,"context_line":"   benefit of using Sphinx extensions like auto-doc, but requires a location"},{"line_number":48,"context_line":"   for publishing."},{"line_number":49,"context_line":"-  Maintain the status quo (do nothing)"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"bff0334d_54031774","line":48,"range":{"start_line":40,"start_character":0,"end_line":48,"end_character":18},"in_reply_to":"bff0334d_932bfce9","updated":"2017-04-07 08:34:24.000000000","message":"A page for openstackdocstheme in the developer docs is a good idea. Do you think we should also publish openstack-doc-tools there so we can keep the documentation in that repo? Or should doc-tools content be moved to the Contributor Guide?","commit_id":"f666b20916ae43b7d81f4c7e281a6984a69e9db3"}]}