)]}'
{"README.rst":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":117,"context_line":"`OpenStack Documentation contributor guide"},{"line_number":118,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/\u003e`_."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Generated Files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_9abe6a63","line":120,"updated":"2016-03-17 18:55:40.000000000","message":"We use sentence style capitalization for all titles, so lower case \"files\"","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":117,"context_line":"`OpenStack Documentation contributor guide"},{"line_number":118,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/\u003e`_."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Generated Files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_6232aba8","line":120,"in_reply_to":"1af94dfe_9abe6a63","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Generated Files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":124,"context_line":"`Generated Files"},{"line_number":125,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files/\u003e`_"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_5aa98223","line":122,"updated":"2016-03-17 18:55:40.000000000","message":"Insert empty line after the title underline","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Generated Files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":124,"context_line":"`Generated Files"},{"line_number":125,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files/\u003e`_"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_2c8b7a69","line":122,"in_reply_to":"1af94dfe_5aa98223","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":124,"context_line":"`Generated Files"},{"line_number":125,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files/\u003e`_"},{"line_number":126,"context_line":"section of the contributor guide."},{"line_number":127,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_9a65ca1f","line":124,"updated":"2016-03-17 18:55:40.000000000","message":"Generated files","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":123,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":124,"context_line":"`Generated Files"},{"line_number":125,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files/\u003e`_"},{"line_number":126,"context_line":"section of the contributor guide."},{"line_number":127,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_6cef421e","line":124,"in_reply_to":"1af94dfe_9a65ca1f","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Generated files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_1866af50","line":123,"range":{"start_line":123,"start_character":52,"end_line":123,"end_character":53},"updated":"2016-03-18 17:03:05.000000000","message":"2 whitespaces","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14151,"name":"ziyu032","email":"chen.qiaomin@99cloud.net","username":"ziyu032"},"change_message_id":"e48d82285ae3936ec13882f87a577754ef219b73","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Generated files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_ae78ef90","line":123,"range":{"start_line":123,"start_character":52,"end_line":123,"end_character":53},"in_reply_to":"1af94dfe_1866af50","updated":"2016-03-20 13:39:46.000000000","message":"+1","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Generated files"},{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Some documentation files are generated using tools.  These files include"},{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_ee48f22f","line":123,"range":{"start_line":123,"start_character":52,"end_line":123,"end_character":53},"in_reply_to":"fa0719c6_ae78ef90","updated":"2016-03-21 21:27:34.000000000","message":"Done","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_"},{"line_number":127,"context_line":"section of the contributor guide."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"Bugs"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_78b5337c","line":127,"range":{"start_line":127,"start_character":15,"end_line":127,"end_character":32},"updated":"2016-03-18 17:03:05.000000000","message":"OpenStack Documentation Contributor Guide","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see the"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_"},{"line_number":127,"context_line":"section of the contributor guide."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"Bugs"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_2e530ae3","line":127,"range":{"start_line":127,"start_character":15,"end_line":127,"end_character":32},"in_reply_to":"1af94dfe_78b5337c","updated":"2016-03-21 21:27:34.000000000","message":"fixed","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"059ecfba1c0061e1da43a1936f8d22792f6e243e","unresolved":false,"context_lines":[{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Some documentation files are generated using tools. These files include"},{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_."},{"line_number":127,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_eeabbc1b","line":124,"range":{"start_line":124,"start_character":3,"end_line":124,"end_character":14},"updated":"2016-03-22 10:52:27.000000000","message":"``do not edit``","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":121,"context_line":"---------------"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"Some documentation files are generated using tools. These files include"},{"line_number":124,"context_line":"a \u0027do not edit\u0027 header and should not be modified by hand. Please see"},{"line_number":125,"context_line":"`Generated files"},{"line_number":126,"context_line":"\u003chttp://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-files/\u003e`_."},{"line_number":127,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_4dfe2639","line":124,"range":{"start_line":124,"start_character":3,"end_line":124,"end_character":14},"in_reply_to":"fa0719c6_eeabbc1b","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"}],"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":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":69,"context_line":"   You will see the following warning in the source file: **\u003c!-- This file is"},{"line_number":70,"context_line":"   automatically generated, do not edit --\u003e**. When you see this, you can still"},{"line_number":71,"context_line":"   update the file using the `openstack-doc-tools`_ tool kit. Please see"},{"line_number":72,"context_line":"   `Generated Files`_ for instructions on how to update these files."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":".. list-table::"},{"line_number":75,"context_line":"   :header-rows: 1"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_fa768ed5","line":72,"updated":"2016-03-17 18:55:40.000000000","message":"lowercase files","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":69,"context_line":"   You will see the following warning in the source file: **\u003c!-- This file is"},{"line_number":70,"context_line":"   automatically generated, do not edit --\u003e**. When you see this, you can still"},{"line_number":71,"context_line":"   update the file using the `openstack-doc-tools`_ tool kit. Please see"},{"line_number":72,"context_line":"   `Generated Files`_ for instructions on how to update these files."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":".. list-table::"},{"line_number":75,"context_line":"   :header-rows: 1"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_2c67fab7","line":72,"in_reply_to":"1af94dfe_fa768ed5","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":138,"context_line":"The release notes are available in the Git repository."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Generated Files"},{"line_number":142,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_ba47e675","line":141,"updated":"2016-03-17 18:55:40.000000000","message":"lowercase files","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":138,"context_line":"The release notes are available in the Git repository."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Generated Files"},{"line_number":142,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_ac9b0a65","line":141,"in_reply_to":"1af94dfe_ba47e675","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":139,"context_line":""},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Generated Files"},{"line_number":142,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_fa5dee47","line":142,"updated":"2016-03-17 18:55:40.000000000","message":"insert empty line after each title - also below","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":139,"context_line":""},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Generated Files"},{"line_number":142,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_eca19295","line":142,"in_reply_to":"1af94dfe_fa5dee47","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":161,"context_line":"    look for the warning at the top of the file before attempting to"},{"line_number":162,"context_line":"    re-generate it."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"Automated Generation"},{"line_number":165,"context_line":"...................."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_ba15264a","line":164,"updated":"2016-03-17 18:55:40.000000000","message":"generation","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":161,"context_line":"    look for the warning at the top of the file before attempting to"},{"line_number":162,"context_line":"    re-generate it."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"Automated Generation"},{"line_number":165,"context_line":"...................."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_cce656e7","line":164,"in_reply_to":"1af94dfe_ba15264a","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."},{"line_number":169,"context_line":"The following instructions demonstrate how to use the script,"},{"line_number":170,"context_line":"using Nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_1516ad4b","line":170,"range":{"start_line":170,"start_character":6,"end_line":170,"end_character":10},"updated":"2016-03-17 18:55:40.000000000","message":"nova","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."},{"line_number":169,"context_line":"The following instructions demonstrate how to use the script,"},{"line_number":170,"context_line":"using Nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_ace94ab9","line":170,"range":{"start_line":170,"start_character":6,"end_line":170,"end_character":10},"in_reply_to":"1af94dfe_1516ad4b","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"    git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_b52379a6","line":174,"updated":"2016-03-17 18:55:40.000000000","message":"Add \"$ \" for command lines everywhere","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"    git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_eccfd253","line":174,"in_reply_to":"1af94dfe_b52379a6","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":188,"context_line":"    git show"},{"line_number":189,"context_line":"    git review"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"Manual Generation"},{"line_number":192,"context_line":"................."},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"Sometimes it may be necessary to re-generate these files manually."}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_954f5d6a","line":191,"updated":"2016-03-17 18:55:40.000000000","message":"generation","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":188,"context_line":"    git show"},{"line_number":189,"context_line":"    git review"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"Manual Generation"},{"line_number":192,"context_line":"................."},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"Sometimes it may be necessary to re-generate these files manually."}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_8c2e0ef9","line":191,"in_reply_to":"1af94dfe_954f5d6a","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":204,"context_line":"    pushd \u003cwork_dir\u003e"},{"line_number":205,"context_line":"    git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":206,"context_line":"    cd openstack-doc-tools"},{"line_number":207,"context_line":"    python setup.py develop"},{"line_number":208,"context_line":"    popd"},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_95763da2","line":207,"updated":"2016-03-17 18:55:40.000000000","message":"use \"pip install .\" instead","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":204,"context_line":"    pushd \u003cwork_dir\u003e"},{"line_number":205,"context_line":"    git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":206,"context_line":"    cd openstack-doc-tools"},{"line_number":207,"context_line":"    python setup.py develop"},{"line_number":208,"context_line":"    popd"},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_8ff1e06d","line":207,"in_reply_to":"1af94dfe_95763da2","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5012c838d647e058e443fcb07e3d77f309b786e4","unresolved":false,"context_lines":[{"line_number":230,"context_line":".. _`Doc Migration from DocBook to RST`: https://wiki.openstack.org/wiki/Documentation/Migrate"},{"line_number":231,"context_line":".. _`development workflow`: http://docs.openstack.org/infra/manual/developers.html#development-workflow"},{"line_number":232,"context_line":".. _`Speciality Teams`: https://wiki.openstack.org/wiki/Documentation/SpecialityTeams"},{"line_number":233,"context_line":".. _`Generated Files`: http://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files"},{"line_number":234,"context_line":".. _`documentation cross-project liaisons`: https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation"},{"line_number":235,"context_line":".. _`openstack-doc-tools`: http://git.openstack.org/cgit/openstack/openstack-doc-tools/tree/README.rst"},{"line_number":236,"context_line":".. _`Sphinx documentation`: http://sphinx-doc.org/rest.html"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_f567c1e6","line":233,"updated":"2016-03-17 18:55:40.000000000","message":"files","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"d3e392ae1425ce45873936b50560ad221ec86c58","unresolved":false,"context_lines":[{"line_number":230,"context_line":".. _`Doc Migration from DocBook to RST`: https://wiki.openstack.org/wiki/Documentation/Migrate"},{"line_number":231,"context_line":".. _`development workflow`: http://docs.openstack.org/infra/manual/developers.html#development-workflow"},{"line_number":232,"context_line":".. _`Speciality Teams`: https://wiki.openstack.org/wiki/Documentation/SpecialityTeams"},{"line_number":233,"context_line":".. _`Generated Files`: http://docs.openstack.org/contributor-guide/tools-and-content-overview.html#Generated-Files"},{"line_number":234,"context_line":".. _`documentation cross-project liaisons`: https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation"},{"line_number":235,"context_line":".. _`openstack-doc-tools`: http://git.openstack.org/cgit/openstack/openstack-doc-tools/tree/README.rst"},{"line_number":236,"context_line":".. _`Sphinx documentation`: http://sphinx-doc.org/rest.html"}],"source_content_type":"text/x-rst","patch_set":7,"id":"1af94dfe_2f8b6c69","line":233,"in_reply_to":"1af94dfe_f567c1e6","updated":"2016-03-18 15:19:50.000000000","message":"Done","commit_id":"0fb99008119e6289266f95937dddbcc2a5df0b2a"},{"author":{"_account_id":14151,"name":"ziyu032","email":"chen.qiaomin@99cloud.net","username":"ziyu032"},"change_message_id":"e48d82285ae3936ec13882f87a577754ef219b73","unresolved":false,"context_lines":[{"line_number":68,"context_line":"   such as the configuration option tables and the CLI reference information."},{"line_number":69,"context_line":"   You will see the following warning in the source file: **\u003c!-- This file is"},{"line_number":70,"context_line":"   automatically generated, do not edit --\u003e**. When you see this, you can still"},{"line_number":71,"context_line":"   update the file using the `openstack-doc-tools`_ tool kit. Please see"},{"line_number":72,"context_line":"   `Generated files`_ for instructions on how to update these files."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":".. list-table::"},{"line_number":75,"context_line":"   :header-rows: 1"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_6e48975c","line":72,"range":{"start_line":71,"start_character":62,"end_line":72,"end_character":22},"updated":"2016-03-20 13:39:46.000000000","message":"Please see the","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":68,"context_line":"   such as the configuration option tables and the CLI reference information."},{"line_number":69,"context_line":"   You will see the following warning in the source file: **\u003c!-- This file is"},{"line_number":70,"context_line":"   automatically generated, do not edit --\u003e**. When you see this, you can still"},{"line_number":71,"context_line":"   update the file using the `openstack-doc-tools`_ tool kit. Please see"},{"line_number":72,"context_line":"   `Generated files`_ for instructions on how to update these files."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":".. list-table::"},{"line_number":75,"context_line":"   :header-rows: 1"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_6b04d414","line":72,"range":{"start_line":71,"start_character":62,"end_line":72,"end_character":22},"in_reply_to":"fa0719c6_6e48975c","updated":"2016-03-21 21:27:34.000000000","message":"Adding an article would make the sentence grammatically incorrect, IMO.","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"``openstack-doc-tools``."},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_5b37914c","line":144,"range":{"start_line":144,"start_character":23,"end_line":144,"end_character":27},"updated":"2016-03-18 17:03:05.000000000","message":"Remove \u0027will\u0027.","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They will contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"``openstack-doc-tools``."},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_ab0eec31","line":144,"range":{"start_line":144,"start_character":23,"end_line":144,"end_character":27},"in_reply_to":"1af94dfe_5b37914c","updated":"2016-03-21 21:27:34.000000000","message":"Done","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"``openstack-doc-tools``."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"CLI-reference"},{"line_number":149,"context_line":"-------------"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"The ``doc/cli-reference`` directory contains documentation for"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_9b93d95a","line":148,"range":{"start_line":148,"start_character":0,"end_line":148,"end_character":13},"updated":"2016-03-18 17:03:05.000000000","message":"CLI Reference (capitalize this title if you mean the name of the guide) or CLI reference (remove n-dash if it\u0027s a descriptive title).","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"``openstack-doc-tools``."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"CLI-reference"},{"line_number":149,"context_line":"-------------"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"The ``doc/cli-reference`` directory contains documentation for"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_0b143842","line":148,"range":{"start_line":148,"start_character":0,"end_line":148,"end_character":13},"in_reply_to":"1af94dfe_9b93d95a","updated":"2016-03-21 21:27:34.000000000","message":"Done","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":149,"context_line":"-------------"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"The ``doc/cli-reference`` directory contains documentation for"},{"line_number":152,"context_line":"OpenStack\u0027s Python clients\u0027 command-line interface."},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"Most of these files are generated using the ``openstack-auto-commands``"},{"line_number":155,"context_line":"tool found in the ``openstack-doc-tools`` repository. See the repository"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_bb70550c","line":152,"range":{"start_line":152,"start_character":0,"end_line":152,"end_character":11},"updated":"2016-03-18 17:03:05.000000000","message":"OpenStack","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":149,"context_line":"-------------"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"The ``doc/cli-reference`` directory contains documentation for"},{"line_number":152,"context_line":"OpenStack\u0027s Python clients\u0027 command-line interface."},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"Most of these files are generated using the ``openstack-auto-commands``"},{"line_number":155,"context_line":"tool found in the ``openstack-doc-tools`` repository. See the repository"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_3bca851b","line":152,"range":{"start_line":152,"start_character":49,"end_line":152,"end_character":50},"updated":"2016-03-18 17:03:05.000000000","message":"interfaces","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":149,"context_line":"-------------"},{"line_number":150,"context_line":""},{"line_number":151,"context_line":"The ``doc/cli-reference`` directory contains documentation for"},{"line_number":152,"context_line":"OpenStack\u0027s Python clients\u0027 command-line interface."},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"Most of these files are generated using the ``openstack-auto-commands``"},{"line_number":155,"context_line":"tool found in the ``openstack-doc-tools`` repository. See the repository"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_8b2688b8","line":152,"range":{"start_line":152,"start_character":0,"end_line":152,"end_character":11},"in_reply_to":"1af94dfe_bb70550c","updated":"2016-03-21 21:27:34.000000000","message":"Fixed","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":158,"context_line":""},{"line_number":159,"context_line":".. important::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    A few of the files are still manually maintained. If unsure, please"},{"line_number":162,"context_line":"    look for the warning at the top of the file before attempting to"},{"line_number":163,"context_line":"    re-generate it."},{"line_number":164,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_7b436d6c","line":161,"range":{"start_line":161,"start_character":65,"end_line":161,"end_character":71},"updated":"2016-03-18 17:03:05.000000000","message":"Please, remove \u0027please\u0027. \u003d)","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":158,"context_line":""},{"line_number":159,"context_line":".. important::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    A few of the files are still manually maintained. If unsure, please"},{"line_number":162,"context_line":"    look for the warning at the top of the file before attempting to"},{"line_number":163,"context_line":"    re-generate it."},{"line_number":164,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_fb801d8d","line":161,"range":{"start_line":161,"start_character":4,"end_line":161,"end_character":16},"updated":"2016-03-18 17:03:05.000000000","message":"Some","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":158,"context_line":""},{"line_number":159,"context_line":".. important::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    A few of the files are still manually maintained. If unsure, please"},{"line_number":162,"context_line":"    look for the warning at the top of the file before attempting to"},{"line_number":163,"context_line":"    re-generate it."},{"line_number":164,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_6b2b3483","line":161,"range":{"start_line":161,"start_character":4,"end_line":161,"end_character":16},"in_reply_to":"1af94dfe_fb801d8d","updated":"2016-03-21 21:27:34.000000000","message":"Done","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":214,"context_line":"    $ pushd \u003cwork_dir\u003e"},{"line_number":215,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":216,"context_line":"    $ cd openstack-doc-tools"},{"line_number":217,"context_line":"    $ pip install ."},{"line_number":218,"context_line":"    $ popd"},{"line_number":219,"context_line":""},{"line_number":220,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_1e0b37d7","line":217,"range":{"start_line":217,"start_character":6,"end_line":217,"end_character":19},"updated":"2016-03-18 17:03:05.000000000","message":"Is the command missing smth?","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":214,"context_line":"    $ pushd \u003cwork_dir\u003e"},{"line_number":215,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":216,"context_line":"    $ cd openstack-doc-tools"},{"line_number":217,"context_line":"    $ pip install ."},{"line_number":218,"context_line":"    $ popd"},{"line_number":219,"context_line":""},{"line_number":220,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_21f34d0c","line":217,"range":{"start_line":217,"start_character":6,"end_line":217,"end_character":19},"in_reply_to":"1af94dfe_1e0b37d7","updated":"2016-03-21 21:27:34.000000000","message":"No","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"b62b3a013cd93d0aa892b223956fb0436c759189","unresolved":false,"context_lines":[{"line_number":232,"context_line":""},{"line_number":233,"context_line":"    $ openstack-auto-commands --help"},{"line_number":234,"context_line":""},{"line_number":235,"context_line":"Once you are satisfied that the generated files look acceptable, they can be"},{"line_number":236,"context_line":"submitted for review in the same manner as any other update."},{"line_number":237,"context_line":""},{"line_number":238,"context_line":".. Links:"},{"line_number":239,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"1af94dfe_fe6beb82","line":236,"range":{"start_line":235,"start_character":23,"end_line":236,"end_character":59},"updated":"2016-03-18 17:03:05.000000000","message":"Rephrase suggestion: \u0027... with the generated files, submit them for review as a usual commit.\u0027","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"4754969b4efb4cc3013ef99fa1aeaab1300bdb13","unresolved":false,"context_lines":[{"line_number":232,"context_line":""},{"line_number":233,"context_line":"    $ openstack-auto-commands --help"},{"line_number":234,"context_line":""},{"line_number":235,"context_line":"Once you are satisfied that the generated files look acceptable, they can be"},{"line_number":236,"context_line":"submitted for review in the same manner as any other update."},{"line_number":237,"context_line":""},{"line_number":238,"context_line":".. Links:"},{"line_number":239,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_d93b3dea","line":236,"range":{"start_line":235,"start_character":23,"end_line":236,"end_character":59},"in_reply_to":"1af94dfe_fe6beb82","updated":"2016-03-21 21:27:34.000000000","message":"This changes the meaning somewhat - how can you not be satisfied with a generated file?","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"550edcc6f35dc1b7bed27493b4799568aad6860e","unresolved":false,"context_lines":[{"line_number":232,"context_line":""},{"line_number":233,"context_line":"    $ openstack-auto-commands --help"},{"line_number":234,"context_line":""},{"line_number":235,"context_line":"Once you are satisfied that the generated files look acceptable, they can be"},{"line_number":236,"context_line":"submitted for review in the same manner as any other update."},{"line_number":237,"context_line":""},{"line_number":238,"context_line":".. Links:"},{"line_number":239,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fa0719c6_13629bad","line":236,"range":{"start_line":235,"start_character":23,"end_line":236,"end_character":59},"in_reply_to":"fa0719c6_d93b3dea","updated":"2016-03-22 10:17:16.000000000","message":"Makes sense. Then you can rephrase in another way, for ex.: Once you finish updating the generated files, submit them in a usual manner.","commit_id":"03e1bdae35d694dbf27f5a841f614257bee4cdc7"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":140,"context_line":"Generated files"},{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_ff689ebc","line":143,"range":{"start_line":143,"start_character":29,"end_line":143,"end_character":38},"updated":"2016-03-21 22:57:15.000000000","message":"clarify by saying  \"automatically generated\" ?","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":140,"context_line":"Generated files"},{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_6d032243","line":143,"range":{"start_line":143,"start_character":29,"end_line":143,"end_character":38},"in_reply_to":"fa0719c6_ff689ebc","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"059ecfba1c0061e1da43a1936f8d22792f6e243e","unresolved":false,"context_lines":[{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_2e649420","line":144,"range":{"start_line":144,"start_character":34,"end_line":144,"end_character":45},"updated":"2016-03-22 10:52:27.000000000","message":"``do not edit``","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_9faa42d3","line":144,"range":{"start_line":144,"start_character":33,"end_line":144,"end_character":46},"updated":"2016-03-21 22:57:15.000000000","message":"copy the exact message from the top of the file so it is clear","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":141,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_2db76a87","line":144,"range":{"start_line":144,"start_character":34,"end_line":144,"end_character":45},"in_reply_to":"fa0719c6_2e649420","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"CLI reference"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_7f9beec9","line":145,"range":{"start_line":145,"start_character":25,"end_line":145,"end_character":26},"updated":"2016-03-21 22:57:15.000000000","message":"remove, unnecessary","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Some documentation files are generated and these should not be"},{"line_number":144,"context_line":"modified by hand. They contain a \u0027do not edit\u0027 warning at"},{"line_number":145,"context_line":"the beginning of the file, and should only be generated using"},{"line_number":146,"context_line":"the :ref:`doc-tools` tool kit."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"CLI reference"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_ad309a02","line":145,"range":{"start_line":145,"start_character":25,"end_line":145,"end_character":26},"in_reply_to":"fa0719c6_7f9beec9","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":162,"context_line":"    warning at the top of the file before attempting to re-generate it."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"Automated generation"},{"line_number":165,"context_line":"...................."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_df931aa2","line":165,"range":{"start_line":165,"start_character":1,"end_line":165,"end_character":20},"updated":"2016-03-21 22:57:15.000000000","message":"http://docs.openstack.org/contributor-guide/rst-conv/titles.html please use the correct underlining.\nFor the forth tier lining, use the ^^^^^","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":162,"context_line":"    warning at the top of the file before attempting to re-generate it."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"Automated generation"},{"line_number":165,"context_line":"...................."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_e82600b9","line":165,"range":{"start_line":165,"start_character":1,"end_line":165,"end_character":20},"in_reply_to":"fa0719c6_df931aa2","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."},{"line_number":169,"context_line":"The following instructions demonstrate how to use this script,"},{"line_number":170,"context_line":"using nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_5feeea22","line":169,"range":{"start_line":169,"start_character":61,"end_line":169,"end_character":62},"updated":"2016-03-21 22:57:15.000000000","message":"remove comma","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Within the ``openstack-doc-tools`` repository, there is a script to"},{"line_number":168,"context_line":"automate submission of an update to a client CLI documentation file."},{"line_number":169,"context_line":"The following instructions demonstrate how to use this script,"},{"line_number":170,"context_line":"using nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_480f342e","line":169,"range":{"start_line":169,"start_character":61,"end_line":169,"end_character":62},"in_reply_to":"fa0719c6_5feeea22","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"05cd20d7ecb8ad6ca594279f2493846b4f9676f6","unresolved":false,"context_lines":[{"line_number":169,"context_line":"The following instructions demonstrate how to use this script,"},{"line_number":170,"context_line":"using nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_d345c3b3","line":172,"range":{"start_line":172,"start_character":20,"end_line":172,"end_character":22},"updated":"2016-03-22 10:54:54.000000000","message":"Instead of using :: for commands, please use:\n\n.. code-block:: console\n\nPlease update all the patch where applicable.","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"059ecfba1c0061e1da43a1936f8d22792f6e243e","unresolved":false,"context_lines":[{"line_number":169,"context_line":"The following instructions demonstrate how to use this script,"},{"line_number":170,"context_line":"using nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_0e1c3076","line":172,"range":{"start_line":172,"start_character":20,"end_line":172,"end_character":22},"updated":"2016-03-22 10:52:27.000000000","message":"Not sure here, but I think we normally use .. code::","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":169,"context_line":"The following instructions demonstrate how to use this script,"},{"line_number":170,"context_line":"using nova as an example client CLI."},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Clone the tools repo::"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_888cac80","line":172,"range":{"start_line":172,"start_character":20,"end_line":172,"end_character":22},"in_reply_to":"fa0719c6_d345c3b3","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":174,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"},{"line_number":178,"context_line":"install the necessary software and run the tool to re-generate the file::"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"    $ ./doc-tools-update-cli-reference nova"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_3fe85610","line":177,"range":{"start_line":177,"start_character":66,"end_line":177,"end_character":67},"updated":"2016-03-21 22:57:15.000000000","message":"full stop here","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":174,"context_line":"    $ git clone git://git.openstack.org/openstack/openstack-doc-tools"},{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"},{"line_number":178,"context_line":"install the necessary software and run the tool to re-generate the file::"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"    $ ./doc-tools-update-cli-reference nova"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_08453c16","line":177,"range":{"start_line":177,"start_character":66,"end_line":177,"end_character":67},"in_reply_to":"fa0719c6_3fe85610","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"},{"line_number":178,"context_line":"install the necessary software and run the tool to re-generate the file::"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"    $ ./doc-tools-update-cli-reference nova"},{"line_number":181,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_7fd00e54","line":178,"range":{"start_line":178,"start_character":0,"end_line":178,"end_character":1},"updated":"2016-03-21 22:57:15.000000000","message":"start a new sentence here","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":175,"context_line":"    $ cd openstack-doc-tools/bin"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Run the automated script. This will generate a virtual environment,"},{"line_number":178,"context_line":"install the necessary software and run the tool to re-generate the file::"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"    $ ./doc-tools-update-cli-reference nova"},{"line_number":181,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_684cb042","line":178,"range":{"start_line":178,"start_character":0,"end_line":178,"end_character":1},"in_reply_to":"fa0719c6_7fd00e54","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":198,"context_line":"    can be generated with the updated content."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Manual generation"},{"line_number":201,"context_line":"................."},{"line_number":202,"context_line":""},{"line_number":203,"context_line":"Sometimes it may be necessary to re-generate these files manually."},{"line_number":204,"context_line":"To do this, you must have ``openstack-doc-tools`` installed::"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_9f1402f6","line":201,"range":{"start_line":201,"start_character":0,"end_line":201,"end_character":17},"updated":"2016-03-21 22:57:15.000000000","message":"ditto","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"05cd20d7ecb8ad6ca594279f2493846b4f9676f6","unresolved":false,"context_lines":[{"line_number":205,"context_line":""},{"line_number":206,"context_line":"    $ pip install openstack-doc-tools"},{"line_number":207,"context_line":""},{"line_number":208,"context_line":"In some cases it may be better to clone the repository in order to"},{"line_number":209,"context_line":"insure that you have the latest tool changes. This is also"},{"line_number":210,"context_line":"necessary if you must make changes to the tool in order to generate a"},{"line_number":211,"context_line":"proper file::"},{"line_number":212,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_ee4c5c72","line":209,"range":{"start_line":208,"start_character":0,"end_line":209,"end_character":45},"updated":"2016-03-22 10:54:54.000000000","message":"Wording suggestion:\n\nTo ensure that you have the latest tool changes, clone the repository.","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":205,"context_line":""},{"line_number":206,"context_line":"    $ pip install openstack-doc-tools"},{"line_number":207,"context_line":""},{"line_number":208,"context_line":"In some cases it may be better to clone the repository in order to"},{"line_number":209,"context_line":"insure that you have the latest tool changes. This is also"},{"line_number":210,"context_line":"necessary if you must make changes to the tool in order to generate a"},{"line_number":211,"context_line":"proper file::"},{"line_number":212,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_082a5c2c","line":209,"range":{"start_line":208,"start_character":0,"end_line":209,"end_character":45},"in_reply_to":"fa0719c6_ee4c5c72","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"05cd20d7ecb8ad6ca594279f2493846b4f9676f6","unresolved":false,"context_lines":[{"line_number":207,"context_line":""},{"line_number":208,"context_line":"In some cases it may be better to clone the repository in order to"},{"line_number":209,"context_line":"insure that you have the latest tool changes. This is also"},{"line_number":210,"context_line":"necessary if you must make changes to the tool in order to generate a"},{"line_number":211,"context_line":"proper file::"},{"line_number":212,"context_line":""},{"line_number":213,"context_line":"    $ pushd \u003cwork_dir\u003e"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_ce47d849","line":210,"range":{"start_line":210,"start_character":17,"end_line":210,"end_character":21},"updated":"2016-03-22 10:54:54.000000000","message":"Remove \u0027must\u0027.","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":207,"context_line":""},{"line_number":208,"context_line":"In some cases it may be better to clone the repository in order to"},{"line_number":209,"context_line":"insure that you have the latest tool changes. This is also"},{"line_number":210,"context_line":"necessary if you must make changes to the tool in order to generate a"},{"line_number":211,"context_line":"proper file::"},{"line_number":212,"context_line":""},{"line_number":213,"context_line":"    $ pushd \u003cwork_dir\u003e"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_e8d3a036","line":210,"range":{"start_line":210,"start_character":17,"end_line":210,"end_character":21},"in_reply_to":"fa0719c6_ce47d849","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"54340eb7371efbdc23ee585e98ba6650d67771b3","unresolved":false,"context_lines":[{"line_number":217,"context_line":"    $ popd"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"},{"line_number":220,"context_line":"``openstack-manuals`` clone, and run the ``openstack-auto-commands``"},{"line_number":221,"context_line":"command::"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"    $ cd /path/to/openstack-manuals/doc/cli-reference/source"}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_7f2c8e4a","line":220,"range":{"start_line":220,"start_character":27,"end_line":220,"end_character":28},"updated":"2016-03-21 22:57:15.000000000","message":"remove this comma too","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":217,"context_line":"    $ popd"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"Change to the ``doc/cli-reference/source`` directory of your"},{"line_number":220,"context_line":"``openstack-manuals`` clone, and run the ``openstack-auto-commands``"},{"line_number":221,"context_line":"command::"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"    $ cd /path/to/openstack-manuals/doc/cli-reference/source"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_08e1bcfe","line":220,"range":{"start_line":220,"start_character":27,"end_line":220,"end_character":28},"in_reply_to":"fa0719c6_7f2c8e4a","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"05cd20d7ecb8ad6ca594279f2493846b4f9676f6","unresolved":false,"context_lines":[{"line_number":227,"context_line":""},{"line_number":228,"context_line":"    $ openstack-auto-commands \u003cclient_name\u003e"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"See the following for more options::"},{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    $ openstack-auto-commands --help"},{"line_number":233,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_53eb73b0","line":230,"range":{"start_line":230,"start_character":0,"end_line":230,"end_character":27},"updated":"2016-03-22 10:54:54.000000000","message":"Wording suggestion:\n\nTo check a list of available options, run:","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":227,"context_line":""},{"line_number":228,"context_line":"    $ openstack-auto-commands \u003cclient_name\u003e"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"See the following for more options::"},{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    $ openstack-auto-commands --help"},{"line_number":233,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_a8f248d0","line":230,"range":{"start_line":230,"start_character":0,"end_line":230,"end_character":27},"in_reply_to":"fa0719c6_53eb73b0","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"05cd20d7ecb8ad6ca594279f2493846b4f9676f6","unresolved":false,"context_lines":[{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    $ openstack-auto-commands --help"},{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Once you are satisfied with the generated files, they can be"},{"line_number":235,"context_line":"submitted for review in the usual manner."},{"line_number":236,"context_line":""},{"line_number":237,"context_line":".. Links:"},{"line_number":238,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"fa0719c6_b3964f4a","line":235,"range":{"start_line":234,"start_character":49,"end_line":235,"end_character":9},"updated":"2016-03-22 10:54:54.000000000","message":"Please consider my suggestion from patch 9.","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"ecf24fd63d77210bdc49237237d5dc6f7b196ec6","unresolved":false,"context_lines":[{"line_number":231,"context_line":""},{"line_number":232,"context_line":"    $ openstack-auto-commands --help"},{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Once you are satisfied with the generated files, they can be"},{"line_number":235,"context_line":"submitted for review in the usual manner."},{"line_number":236,"context_line":""},{"line_number":237,"context_line":".. Links:"},{"line_number":238,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a18252c_88a94c7e","line":235,"range":{"start_line":234,"start_character":49,"end_line":235,"end_character":9},"in_reply_to":"fa0719c6_b3964f4a","updated":"2016-04-13 12:59:53.000000000","message":"Done","commit_id":"964520f86668922dde7fc3c6522d61ae825a60f2"}]}