)]}'
{"doc/contributor-guide/source/tools_and_content_overview.rst":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Tools and content overview"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The tool used for documentation depends on guides. For example, we use DocBook"},{"line_number":8,"context_line":"for the Operations Guide in openstack/operations-guide. And we use"},{"line_number":9,"context_line":"ReStructured Text (RST) files stored in source code for developer docs and for"},{"line_number":10,"context_line":"guides such as End User Guide, Admin User Guide and many other guides."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_9ba4534b","line":7,"updated":"2015-10-09 17:25:13.000000000","message":"I would say it\u0027s historic: In the past we used DocBook, we now use RST and convert guides from DocBook to RST.","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Tools and content overview"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The tool used for documentation depends on guides. For example, we use DocBook"},{"line_number":8,"context_line":"for the Operations Guide in openstack/operations-guide. And we use"},{"line_number":9,"context_line":"ReStructured Text (RST) files stored in source code for developer docs and for"},{"line_number":10,"context_line":"guides such as End User Guide, Admin User Guide and many other guides."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_0ace7db4","line":7,"in_reply_to":"7a2fa921_9ba4534b","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":9,"context_line":"ReStructured Text (RST) files stored in source code for developer docs and for"},{"line_number":10,"context_line":"guides such as End User Guide, Admin User Guide and many other guides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"To work on the RST source files, find the :file:`/doc/source/` directory in a"},{"line_number":13,"context_line":"given OpenStack project to work on the source .rst files. These are built to"},{"line_number":14,"context_line":"*docs.openstack.org/\u003cguide-name\u003e*, for example, http://docs.openstack.org/user-guide-admin."},{"line_number":15,"context_line":"Developer docs are built to *docs.openstack.org/developer/\u003cproject\u003e*, for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_db75ebca","line":12,"updated":"2015-10-09 17:25:13.000000000","message":"doc/GUIDE/source","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":9,"context_line":"ReStructured Text (RST) files stored in source code for developer docs and for"},{"line_number":10,"context_line":"guides such as End User Guide, Admin User Guide and many other guides."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"To work on the RST source files, find the :file:`/doc/source/` directory in a"},{"line_number":13,"context_line":"given OpenStack project to work on the source .rst files. These are built to"},{"line_number":14,"context_line":"*docs.openstack.org/\u003cguide-name\u003e*, for example, http://docs.openstack.org/user-guide-admin."},{"line_number":15,"context_line":"Developer docs are built to *docs.openstack.org/developer/\u003cproject\u003e*, for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_67daca19","line":12,"in_reply_to":"7a2fa921_db75ebca","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":12,"context_line":"To work on the RST source files, find the :file:`/doc/source/` directory in a"},{"line_number":13,"context_line":"given OpenStack project to work on the source .rst files. These are built to"},{"line_number":14,"context_line":"*docs.openstack.org/\u003cguide-name\u003e*, for example, http://docs.openstack.org/user-guide-admin."},{"line_number":15,"context_line":"Developer docs are built to *docs.openstack.org/developer/\u003cproject\u003e*, for"},{"line_number":16,"context_line":"example, http://docs.openstack.org/developer/nova."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Many cross-project manuals are in the http://git.openstack.org/cgit/openstack/openstack-manuals/tree/ project."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_1b3da3dc","line":15,"updated":"2015-10-09 17:25:13.000000000","message":"I would not mention developer docs here since they have different layout. They do use doc/source - and are in repositories outside of documentation team","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":12,"context_line":"To work on the RST source files, find the :file:`/doc/source/` directory in a"},{"line_number":13,"context_line":"given OpenStack project to work on the source .rst files. These are built to"},{"line_number":14,"context_line":"*docs.openstack.org/\u003cguide-name\u003e*, for example, http://docs.openstack.org/user-guide-admin."},{"line_number":15,"context_line":"Developer docs are built to *docs.openstack.org/developer/\u003cproject\u003e*, for"},{"line_number":16,"context_line":"example, http://docs.openstack.org/developer/nova."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Many cross-project manuals are in the http://git.openstack.org/cgit/openstack/openstack-manuals/tree/ project."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_cdd97f85","line":15,"in_reply_to":"7a2fa921_1b3da3dc","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":"To work on the DocBook and WADL source files for http://developer.openstack.org,"},{"line_number":21,"context_line":"look for the http://git.openstack.org/cgit/openstack/api-site/tree/ project on"},{"line_number":22,"context_line":"Github and use the same `development workflow`_."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"The builds are listed on the :ref:`docs_builds` page, showing what"},{"line_number":25,"context_line":"source files are built from."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_1b14c34a","line":22,"updated":"2015-10-09 17:25:13.000000000","message":"github? No","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":"To work on the DocBook and WADL source files for http://developer.openstack.org,"},{"line_number":21,"context_line":"look for the http://git.openstack.org/cgit/openstack/api-site/tree/ project on"},{"line_number":22,"context_line":"Github and use the same `development workflow`_."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"The builds are listed on the :ref:`docs_builds` page, showing what"},{"line_number":25,"context_line":"source files are built from."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_27b5b2cf","line":22,"in_reply_to":"7a2fa921_1b14c34a","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":132,"context_line":"------------"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"The Cloud Doc Tools Maven plug-in provides a build tool that Jenkins can use"},{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_c6442e4b","line":135,"updated":"2015-10-09 17:25:13.000000000","message":"Use git.openstack.org everywhere","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":132,"context_line":"------------"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"The Cloud Doc Tools Maven plug-in provides a build tool that Jenkins can use"},{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_e4425868","line":135,"in_reply_to":"7a2fa921_c6442e4b","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":133,"context_line":""},{"line_number":134,"context_line":"The Cloud Doc Tools Maven plug-in provides a build tool that Jenkins can use"},{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."},{"line_number":139,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_a65c9219","line":136,"updated":"2015-10-09 17:25:13.000000000","message":"openstack-manuals launchpad project","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":133,"context_line":""},{"line_number":134,"context_line":"The Cloud Doc Tools Maven plug-in provides a build tool that Jenkins can use"},{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."},{"line_number":139,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_049d1459","line":136,"in_reply_to":"7a2fa921_a65c9219","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f1a0b1a49e8210c23352a1d6180b13a7cb21532d","unresolved":false,"context_lines":[{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":".. Links:"},{"line_number":141,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_667afa89","line":138,"updated":"2015-10-09 17:25:13.000000000","message":"github -\u003e in the git repository","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"39452c52e541afea84071c76668733598ff58ede","unresolved":false,"context_lines":[{"line_number":135,"context_line":"to build PDF and HTML from DocBook and WADL source files. It is maintained at https://github.com/stackforge/clouddocs-maven-plugin. We track bugs against"},{"line_number":136,"context_line":"the output in the OpenStack Core Infrastructure launchpad project."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"The release notes are available on Github."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":".. Links:"},{"line_number":141,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a2fa921_448c6c35","line":138,"in_reply_to":"7a2fa921_667afa89","updated":"2015-10-12 12:45:34.000000000","message":"Done","commit_id":"c0cdfcc97ed50bed25c001ef7787ba1c4b0a2329"}]}