)]}'
{"doc/source/devref/documenting_your_work.rst":[{"author":{"_account_id":6938,"name":"Alexey Ovchinnikov","email":"aovchinnikov@mirantis.com","username":"aovchinnikov"},"change_message_id":"9a792b3878f288ba7500eb0bb08bc640a30a9ed0","unresolved":false,"context_lines":[{"line_number":22,"context_line":"- Any documentation targeted at end users of manila in OpenStack needs to go"},{"line_number":23,"context_line":"  here. This contains high level information about any feature as long as it"},{"line_number":24,"context_line":"  is available on ``python-manilaclient`` and/or ``manila-ui``."},{"line_number":25,"context_line":"- If you develop a feature that is end user facing, you need to provide an"},{"line_number":26,"context_line":"  overview, use cases and example work-flows as part of this documentation."},{"line_number":27,"context_line":"- **Link**: `User guide \u003chttp://docs.openstack.org/user-guide/\u003e`_"},{"line_number":28,"context_line":"- **Repository**: The user guide is maintained within the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_b9d40e20","line":25,"range":{"start_line":25,"start_character":9,"end_line":25,"end_character":50},"updated":"2016-05-26 09:14:47.000000000","message":"Maybe \u0027end user facing feature\u0027 reads slightly better. Or maybe not.","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"73a3f13a38ec4cca3c65e8b7a78a49905515dea8","unresolved":false,"context_lines":[{"line_number":22,"context_line":"- Any documentation targeted at end users of manila in OpenStack needs to go"},{"line_number":23,"context_line":"  here. This contains high level information about any feature as long as it"},{"line_number":24,"context_line":"  is available on ``python-manilaclient`` and/or ``manila-ui``."},{"line_number":25,"context_line":"- If you develop a feature that is end user facing, you need to provide an"},{"line_number":26,"context_line":"  overview, use cases and example work-flows as part of this documentation."},{"line_number":27,"context_line":"- **Link**: `User guide \u003chttp://docs.openstack.org/user-guide/\u003e`_"},{"line_number":28,"context_line":"- **Repository**: The user guide is maintained within the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_0b433514","line":25,"range":{"start_line":25,"start_character":9,"end_line":25,"end_character":50},"in_reply_to":"bab6814e_63494f60","updated":"2016-05-26 13:13:46.000000000","message":"Done","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":22,"context_line":"- Any documentation targeted at end users of manila in OpenStack needs to go"},{"line_number":23,"context_line":"  here. This contains high level information about any feature as long as it"},{"line_number":24,"context_line":"  is available on ``python-manilaclient`` and/or ``manila-ui``."},{"line_number":25,"context_line":"- If you develop a feature that is end user facing, you need to provide an"},{"line_number":26,"context_line":"  overview, use cases and example work-flows as part of this documentation."},{"line_number":27,"context_line":"- **Link**: `User guide \u003chttp://docs.openstack.org/user-guide/\u003e`_"},{"line_number":28,"context_line":"- **Repository**: The user guide is maintained within the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_63494f60","line":25,"range":{"start_line":25,"start_character":9,"end_line":25,"end_character":50},"in_reply_to":"bab6814e_b9d40e20","updated":"2016-05-26 10:51:09.000000000","message":"+1 to \u0027an end user facing feature\u0027.","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":44,"context_line":""},{"line_number":45,"context_line":"OpenStack Configuration Reference"},{"line_number":46,"context_line":"---------------------------------"},{"line_number":47,"context_line":"- Instructions regarding configuration of different manila back ends needs"},{"line_number":48,"context_line":"  be added in this document."},{"line_number":49,"context_line":"- It also contains sections where manila\u0027s configuration options are"},{"line_number":50,"context_line":"  auto-documented."}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_c35abbf1","line":47,"range":{"start_line":47,"start_character":69,"end_line":47,"end_character":74},"updated":"2016-05-26 10:51:09.000000000","message":"need","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":51,"context_line":"- It contains sample configuration files for using manila with various"},{"line_number":52,"context_line":"  configuration styles."},{"line_number":53,"context_line":"- If you are a driver maintainer, please ensure that your driver and all of"},{"line_number":54,"context_line":"  it\u0027s relevant configuration is documented here."},{"line_number":55,"context_line":"- **Link**: `Mitaka release configuration reference"},{"line_number":56,"context_line":"  \u003chttp://docs.openstack.org/mitaka/config-reference/\u003e`_"},{"line_number":57,"context_line":"- **Repository**: The configuration reference is maintained within the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_8388b372","line":54,"range":{"start_line":54,"start_character":2,"end_line":54,"end_character":6},"updated":"2016-05-26 10:51:09.000000000","message":"its","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"73a3f13a38ec4cca3c65e8b7a78a49905515dea8","unresolved":false,"context_lines":[{"line_number":51,"context_line":"- It contains sample configuration files for using manila with various"},{"line_number":52,"context_line":"  configuration styles."},{"line_number":53,"context_line":"- If you are a driver maintainer, please ensure that your driver and all of"},{"line_number":54,"context_line":"  it\u0027s relevant configuration is documented here."},{"line_number":55,"context_line":"- **Link**: `Mitaka release configuration reference"},{"line_number":56,"context_line":"  \u003chttp://docs.openstack.org/mitaka/config-reference/\u003e`_"},{"line_number":57,"context_line":"- **Repository**: The configuration reference is maintained within the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_6b73e180","line":54,"range":{"start_line":54,"start_character":2,"end_line":54,"end_character":6},"in_reply_to":"bab6814e_8388b372","updated":"2016-05-26 13:13:46.000000000","message":"d\u0027oh!","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"OpenStack Installation Guide"},{"line_number":62,"context_line":"----------------------------"},{"line_number":63,"context_line":"- Instructions regarding setting up manila on OpenStack is documented here."},{"line_number":64,"context_line":"  This guide covers step-by-step deployment of OpenStack services using a"},{"line_number":65,"context_line":"  functional example architecture suitable for new users of OpenStack with"},{"line_number":66,"context_line":"  sufficient Linux experience."}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_833d5391","line":63,"range":{"start_line":63,"start_character":56,"end_line":63,"end_character":59},"updated":"2016-05-26 10:51:09.000000000","message":"are","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"73a3f13a38ec4cca3c65e8b7a78a49905515dea8","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"OpenStack Installation Guide"},{"line_number":62,"context_line":"----------------------------"},{"line_number":63,"context_line":"- Instructions regarding setting up manila on OpenStack is documented here."},{"line_number":64,"context_line":"  This guide covers step-by-step deployment of OpenStack services using a"},{"line_number":65,"context_line":"  functional example architecture suitable for new users of OpenStack with"},{"line_number":66,"context_line":"  sufficient Linux experience."}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_ab69498e","line":63,"range":{"start_line":63,"start_character":56,"end_line":63,"end_character":59},"in_reply_to":"bab6814e_833d5391","updated":"2016-05-26 13:13:46.000000000","message":"Done","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":89,"context_line":""},{"line_number":90,"context_line":"OpenStack API Reference"},{"line_number":91,"context_line":"-----------------------"},{"line_number":92,"context_line":"- When you add/change a REST API in manila, you would need to add/edit"},{"line_number":93,"context_line":"  descriptions of the API, request and response parameters, microversions and"},{"line_number":94,"context_line":"  expected HTTP response codes as part of the API reference."},{"line_number":95,"context_line":"- For releases prior to Newton, API reference was maintained in `Web"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_63c66f69","line":92,"range":{"start_line":92,"start_character":11,"end_line":92,"end_character":22},"updated":"2016-05-26 10:51:09.000000000","message":"suggest \u0027add or change\u0027","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":89,"context_line":""},{"line_number":90,"context_line":"OpenStack API Reference"},{"line_number":91,"context_line":"-----------------------"},{"line_number":92,"context_line":"- When you add/change a REST API in manila, you would need to add/edit"},{"line_number":93,"context_line":"  descriptions of the API, request and response parameters, microversions and"},{"line_number":94,"context_line":"  expected HTTP response codes as part of the API reference."},{"line_number":95,"context_line":"- For releases prior to Newton, API reference was maintained in `Web"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_a3a217ac","line":92,"range":{"start_line":92,"start_character":62,"end_line":92,"end_character":70},"updated":"2016-05-26 10:51:09.000000000","message":"suggest \u0027add or edit\u0027","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":95,"context_line":"- For releases prior to Newton, API reference was maintained in `Web"},{"line_number":96,"context_line":"  Application Description Language (WADL)"},{"line_number":97,"context_line":"  \u003chttps://en.wikipedia.org/wiki/Web_Application_Description_Language\u003e`_"},{"line_number":98,"context_line":"- In the Newton release, manila\u0027s API reference will be maintained in-tree"},{"line_number":99,"context_line":"  in a custom YAML/JSON format files."},{"line_number":100,"context_line":"- **Links**"},{"line_number":101,"context_line":"  - `REST API reference of the Shared File Systems Project v1.0"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_e37fff14","line":98,"range":{"start_line":98,"start_character":2,"end_line":98,"end_character":23},"updated":"2016-05-26 10:51:09.000000000","message":"Starting with the Newton release ?","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":9003,"name":"Tom Barron","email":"tpb@dyncloud.net","username":"tbarron"},"change_message_id":"ccf4291858f6852403c0583a94057d9d2c4b60fc","unresolved":false,"context_lines":[{"line_number":105,"context_line":"- **Repository**: The API reference is maintained within the"},{"line_number":106,"context_line":"  `OpenStack API Site repository"},{"line_number":107,"context_line":"  \u003chttps://github.com/openstack/api-site\u003e`_. However, from the Newton release,"},{"line_number":108,"context_line":"  manila\u0027s API reference will live in it\u0027s project tree."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":".. TODO(gouthamr): add actual links and repo instructions when available."},{"line_number":111,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_e396df3c","line":108,"range":{"start_line":108,"start_character":38,"end_line":108,"end_character":42},"updated":"2016-05-26 10:51:09.000000000","message":"its","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"73a3f13a38ec4cca3c65e8b7a78a49905515dea8","unresolved":false,"context_lines":[{"line_number":105,"context_line":"- **Repository**: The API reference is maintained within the"},{"line_number":106,"context_line":"  `OpenStack API Site repository"},{"line_number":107,"context_line":"  \u003chttps://github.com/openstack/api-site\u003e`_. However, from the Newton release,"},{"line_number":108,"context_line":"  manila\u0027s API reference will live in it\u0027s project tree."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":".. TODO(gouthamr): add actual links and repo instructions when available."},{"line_number":111,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_764c6442","line":108,"range":{"start_line":108,"start_character":38,"end_line":108,"end_character":42},"in_reply_to":"bab6814e_e396df3c","updated":"2016-05-26 13:13:46.000000000","message":"Done","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":6938,"name":"Alexey Ovchinnikov","email":"aovchinnikov@mirantis.com","username":"aovchinnikov"},"change_message_id":"9a792b3878f288ba7500eb0bb08bc640a30a9ed0","unresolved":false,"context_lines":[{"line_number":145,"context_line":"- When implementing a new feature, use appropriate"},{"line_number":146,"context_line":"  Commit Message Tags (:ref:`commit_message_tags`)."},{"line_number":147,"context_line":"- Using the ``DocImpact`` flag in particular will create a ``[doc]`` bug"},{"line_number":148,"context_line":"  under the `manila project in launchpad \u003chttps://bugs.launchpad"},{"line_number":149,"context_line":"  .net/manila\u003e`_. When your code patch merges, assign this bug to yourself"},{"line_number":150,"context_line":"  and track your documentation changes with it."},{"line_number":151,"context_line":"- When writing documentation outside of manila, use either a commit message"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_9c2c989a","line":148,"updated":"2016-05-26 09:14:47.000000000","message":"If I get this right you should not break links: \nhttp://docs.openstack.org/contributor-guide/rst-conv/gen-guidelines.html#lines-length","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"73a3f13a38ec4cca3c65e8b7a78a49905515dea8","unresolved":false,"context_lines":[{"line_number":145,"context_line":"- When implementing a new feature, use appropriate"},{"line_number":146,"context_line":"  Commit Message Tags (:ref:`commit_message_tags`)."},{"line_number":147,"context_line":"- Using the ``DocImpact`` flag in particular will create a ``[doc]`` bug"},{"line_number":148,"context_line":"  under the `manila project in launchpad \u003chttps://bugs.launchpad"},{"line_number":149,"context_line":"  .net/manila\u003e`_. When your code patch merges, assign this bug to yourself"},{"line_number":150,"context_line":"  and track your documentation changes with it."},{"line_number":151,"context_line":"- When writing documentation outside of manila, use either a commit message"}],"source_content_type":"text/x-rst","patch_set":2,"id":"bab6814e_d6e270d4","line":148,"in_reply_to":"bab6814e_9c2c989a","updated":"2016-05-26 13:13:46.000000000","message":"you\u0027re right.","commit_id":"6471e524fc12af43d1d92dea4ec243a7d679e957"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"f50b107c1a22016ef65bd46999505643e5263280","unresolved":false,"context_lines":[{"line_number":138,"context_line":"- **Repository**: The CLI reference is maintained within the"},{"line_number":139,"context_line":"  `OpenStack Manuals project"},{"line_number":140,"context_line":"  \u003chttps://github.com/openstack/openstack-manuals\u003e`_."},{"line_number":141,"context_line":""},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Important things to note"},{"line_number":144,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bab6814e_b7c51c8f","line":141,"updated":"2016-05-26 16:10:07.000000000","message":"Maybe add a section for the Security guide,\nhttp://docs.openstack.org/security-guide/shared-file-systems.html","commit_id":"b33ee339f4d14670f32836f1c17bb09c83e16ddf"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"0d865afc1536d15eb65d091e10d6fd36073d6a20","unresolved":false,"context_lines":[{"line_number":138,"context_line":"- **Repository**: The CLI reference is maintained within the"},{"line_number":139,"context_line":"  `OpenStack Manuals project"},{"line_number":140,"context_line":"  \u003chttps://github.com/openstack/openstack-manuals\u003e`_."},{"line_number":141,"context_line":""},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"Important things to note"},{"line_number":144,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":4,"id":"bab6814e_750a8927","line":141,"in_reply_to":"bab6814e_b7c51c8f","updated":"2016-05-26 17:48:35.000000000","message":"Thanks, done.. this was a #TIL","commit_id":"b33ee339f4d14670f32836f1c17bb09c83e16ddf"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"5af7b1a996fe3367221a39c9df06f27b58f78867","unresolved":false,"context_lines":[{"line_number":33,"context_line":"-----------------------------"},{"line_number":34,"context_line":"- Documentation for administrators of manila deployments in OpenStack clouds"},{"line_number":35,"context_line":"  needs to go here."},{"line_number":36,"context_line":"- Please document instructions for administrators to perform necessary set up"},{"line_number":37,"context_line":"  for utilizing a feature, along with managing and troubleshooting manila"},{"line_number":38,"context_line":"  when the feature is used."},{"line_number":39,"context_line":"- Relevant configuration options may be mentioned here briefly."}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_58805cbf","line":36,"range":{"start_line":36,"start_character":2,"end_line":36,"end_character":8},"updated":"2016-05-26 18:34:24.000000000","message":"We can remove the \"please\" here.","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"43e965ce6c130fed8da619b4de63fb0af22eb2d7","unresolved":false,"context_lines":[{"line_number":33,"context_line":"-----------------------------"},{"line_number":34,"context_line":"- Documentation for administrators of manila deployments in OpenStack clouds"},{"line_number":35,"context_line":"  needs to go here."},{"line_number":36,"context_line":"- Please document instructions for administrators to perform necessary set up"},{"line_number":37,"context_line":"  for utilizing a feature, along with managing and troubleshooting manila"},{"line_number":38,"context_line":"  when the feature is used."},{"line_number":39,"context_line":"- Relevant configuration options may be mentioned here briefly."}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_44799581","line":36,"range":{"start_line":36,"start_character":2,"end_line":36,"end_character":8},"in_reply_to":"bab6814e_58805cbf","updated":"2016-05-26 19:24:20.000000000","message":"Done","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"5af7b1a996fe3367221a39c9df06f27b58f78867","unresolved":false,"context_lines":[{"line_number":48,"context_line":"  be added in this document."},{"line_number":49,"context_line":"- The configuration reference also contains sections where manila\u0027s"},{"line_number":50,"context_line":"  configuration options are auto-documented."},{"line_number":51,"context_line":"- It contains sample configuration files for using manila with various"},{"line_number":52,"context_line":"  configuration styles."},{"line_number":53,"context_line":"- If you are a driver maintainer, please ensure that your driver and all of"},{"line_number":54,"context_line":"  its relevant configuration is documented here."},{"line_number":55,"context_line":"- **Link**: `Mitaka release configuration reference"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_8b42703c","line":52,"range":{"start_line":51,"start_character":63,"end_line":52,"end_character":22},"updated":"2016-05-26 18:34:24.000000000","message":"Like what? Are we talking such things as DHSS here? We probably want to call out an example or two.","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"43e965ce6c130fed8da619b4de63fb0af22eb2d7","unresolved":false,"context_lines":[{"line_number":48,"context_line":"  be added in this document."},{"line_number":49,"context_line":"- The configuration reference also contains sections where manila\u0027s"},{"line_number":50,"context_line":"  configuration options are auto-documented."},{"line_number":51,"context_line":"- It contains sample configuration files for using manila with various"},{"line_number":52,"context_line":"  configuration styles."},{"line_number":53,"context_line":"- If you are a driver maintainer, please ensure that your driver and all of"},{"line_number":54,"context_line":"  its relevant configuration is documented here."},{"line_number":55,"context_line":"- **Link**: `Mitaka release configuration reference"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_6923d4bd","line":52,"range":{"start_line":51,"start_character":63,"end_line":52,"end_character":22},"in_reply_to":"bab6814e_8b42703c","updated":"2016-05-26 19:24:20.000000000","message":"i meant a combination of options.. it\u0027s detailed in the config-ref","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"5af7b1a996fe3367221a39c9df06f27b58f78867","unresolved":false,"context_lines":[{"line_number":90,"context_line":""},{"line_number":91,"context_line":"OpenStack API Reference"},{"line_number":92,"context_line":"-----------------------"},{"line_number":93,"context_line":"- When you add or change a REST API in manila, you would need to add or edit"},{"line_number":94,"context_line":"  descriptions of the API, request and response parameters, microversions and"},{"line_number":95,"context_line":"  expected HTTP response codes as part of the API reference."},{"line_number":96,"context_line":"- For releases prior to Newton, the API reference was maintained in `Web"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_0bde8010","line":93,"range":{"start_line":93,"start_character":51,"end_line":93,"end_character":56},"updated":"2016-05-26 18:34:24.000000000","message":"s/would/will","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"43e965ce6c130fed8da619b4de63fb0af22eb2d7","unresolved":false,"context_lines":[{"line_number":90,"context_line":""},{"line_number":91,"context_line":"OpenStack API Reference"},{"line_number":92,"context_line":"-----------------------"},{"line_number":93,"context_line":"- When you add or change a REST API in manila, you would need to add or edit"},{"line_number":94,"context_line":"  descriptions of the API, request and response parameters, microversions and"},{"line_number":95,"context_line":"  expected HTTP response codes as part of the API reference."},{"line_number":96,"context_line":"- For releases prior to Newton, the API reference was maintained in `Web"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_8497fd8e","line":93,"range":{"start_line":93,"start_character":51,"end_line":93,"end_character":56},"in_reply_to":"bab6814e_0bde8010","updated":"2016-05-26 19:24:20.000000000","message":"Done","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"5af7b1a996fe3367221a39c9df06f27b58f78867","unresolved":false,"context_lines":[{"line_number":145,"context_line":"--------------------------------"},{"line_number":146,"context_line":"- *Help text* provided in the ``python-manilaclient`` is extracted into this"},{"line_number":147,"context_line":"  document automatically."},{"line_number":148,"context_line":"- No manual corrections are allowed on this repository"},{"line_number":149,"context_line":"- **Link**: `Manila CLI reference"},{"line_number":150,"context_line":"  \u003chttp://docs.openstack.org/cli-reference/manila.html\u003e`_"},{"line_number":151,"context_line":"- **Repository**: The CLI reference is maintained within the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_8b0d5040","line":148,"updated":"2016-05-26 18:34:24.000000000","message":"I would add \"; add any corrections to the help text in the ``python-manilaclient`` repository.\"","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"43e965ce6c130fed8da619b4de63fb0af22eb2d7","unresolved":false,"context_lines":[{"line_number":145,"context_line":"--------------------------------"},{"line_number":146,"context_line":"- *Help text* provided in the ``python-manilaclient`` is extracted into this"},{"line_number":147,"context_line":"  document automatically."},{"line_number":148,"context_line":"- No manual corrections are allowed on this repository"},{"line_number":149,"context_line":"- **Link**: `Manila CLI reference"},{"line_number":150,"context_line":"  \u003chttp://docs.openstack.org/cli-reference/manila.html\u003e`_"},{"line_number":151,"context_line":"- **Repository**: The CLI reference is maintained within the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_24f571ec","line":148,"in_reply_to":"bab6814e_8b0d5040","updated":"2016-05-26 19:24:20.000000000","message":"Done","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"5af7b1a996fe3367221a39c9df06f27b58f78867","unresolved":false,"context_lines":[{"line_number":172,"context_line":"  (``manila``)."},{"line_number":173,"context_line":"- Follow documentation styles prescribed in the `OpenStack Documentation"},{"line_number":174,"context_line":"  Contributor Guide \u003chttp://docs.openstack.org/contributor-guide/\u003e`_. Pay"},{"line_number":175,"context_line":"  heed to `RST formatting conventions"},{"line_number":176,"context_line":"  \u003chttp://docs.openstack.org/contributor-guide/rst-conv.html\u003e`_"},{"line_number":177,"context_line":"  and `Writing style"},{"line_number":178,"context_line":"  \u003chttp://docs.openstack.org/contributor-guide/writing-style.html\u003e`_"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_ce48065f","line":175,"range":{"start_line":175,"start_character":7,"end_line":175,"end_character":9},"updated":"2016-05-26 18:34:24.000000000","message":"s/to/to the","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"43e965ce6c130fed8da619b4de63fb0af22eb2d7","unresolved":false,"context_lines":[{"line_number":172,"context_line":"  (``manila``)."},{"line_number":173,"context_line":"- Follow documentation styles prescribed in the `OpenStack Documentation"},{"line_number":174,"context_line":"  Contributor Guide \u003chttp://docs.openstack.org/contributor-guide/\u003e`_. Pay"},{"line_number":175,"context_line":"  heed to `RST formatting conventions"},{"line_number":176,"context_line":"  \u003chttp://docs.openstack.org/contributor-guide/rst-conv.html\u003e`_"},{"line_number":177,"context_line":"  and `Writing style"},{"line_number":178,"context_line":"  \u003chttp://docs.openstack.org/contributor-guide/writing-style.html\u003e`_"}],"source_content_type":"text/x-rst","patch_set":5,"id":"bab6814e_04382d9f","line":175,"range":{"start_line":175,"start_character":7,"end_line":175,"end_character":9},"in_reply_to":"bab6814e_ce48065f","updated":"2016-05-26 19:24:20.000000000","message":"Done","commit_id":"14ff51901b4cfab0e59ebefffc99e142f1660938"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"c75c7dbc917ff14cbc36eb8fc461b8d8563c252e","unresolved":false,"context_lines":[{"line_number":99,"context_line":"- Starting with the Newton release, manila\u0027s API reference will be maintained"},{"line_number":100,"context_line":"  in-tree in custom YAML/JSON format files."},{"line_number":101,"context_line":"- **Links**"},{"line_number":102,"context_line":"  - `REST API reference of the Shared File Systems Project v1.0"},{"line_number":103,"context_line":"    \u003chttp://developer.openstack.org/api-ref-share-v1.html\u003e`_"},{"line_number":104,"context_line":"  - `REST API reference of the Shared File Systems Project v2.0"},{"line_number":105,"context_line":"    \u003chttp://developer.openstack.org/api-ref-share-v2.html\u003e`_"},{"line_number":106,"context_line":"- **Repository**: The API reference is maintained within the"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bab6814e_84f9bd82","line":103,"range":{"start_line":102,"start_character":2,"end_line":103,"end_character":60},"updated":"2016-05-26 19:37:29.000000000","message":"This bullet point is not appearing correctly in the rendered HTML. It\u0027s placing this section on the same line as the **Links** text.","commit_id":"2c18292c9721481a7e8fa6d928c06b9e49639e3e"},{"author":{"_account_id":17780,"name":"Dustin Schoenbrun","email":"dschoenb@redhat.com","username":"dschoenb"},"change_message_id":"c75c7dbc917ff14cbc36eb8fc461b8d8563c252e","unresolved":false,"context_lines":[{"line_number":170,"context_line":"- When writing documentation in user/admin/config/api/install guides,"},{"line_number":171,"context_line":"  *always* refer to the project with its service type: ``Shared File Systems"},{"line_number":172,"context_line":"  service`` and not the service name (``share``) or the project name"},{"line_number":173,"context_line":"  (``manila``)."},{"line_number":174,"context_line":"- Follow documentation styles prescribed in the `OpenStack Documentation"},{"line_number":175,"context_line":"  Contributor Guide \u003chttp://docs.openstack.org/contributor-guide/\u003e`_. Pay"},{"line_number":176,"context_line":"  heed to the`RST formatting conventions"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bab6814e_e4652945","line":173,"updated":"2016-05-26 19:37:29.000000000","message":"Now that I look at this again, it might be prudent to call out that when you refer to Manila in developer docs and the like to refer to it as \"manila\" and not \"Manila\".","commit_id":"2c18292c9721481a7e8fa6d928c06b9e49639e3e"},{"author":{"_account_id":8056,"name":"Ramana Raja","email":"rraja@redhat.com","username":"Ram_Raja"},"change_message_id":"0f19e221c37d79780d8a5f7f40246316aa62378d","unresolved":false,"context_lines":[{"line_number":189,"context_line":"  these drivers."},{"line_number":190,"context_line":"- **Important \"documentation\" that isn\u0027t really documentation** - ``specs`` and"},{"line_number":191,"context_line":"  ``release notes`` are *NOT* documentation. A specification document is"},{"line_number":192,"context_line":"  written are to initiate a dialogue and gather feedback regarding the"},{"line_number":193,"context_line":"  design of a feature. Neither developers nor users will regard a"},{"line_number":194,"context_line":"  specification as official documentation after a feature has been"},{"line_number":195,"context_line":"  implemented. Release notes (:ref:`adding_release_notes`) allow for"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_dce4be0e","line":192,"updated":"2016-05-29 07:55:13.000000000","message":"s/are//","commit_id":"67f1b1d7efa301b5a1a93d07b06ba65242ea84e3"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"033440b7acfd70f08b49021a43ff2b43f7fb4408","unresolved":false,"context_lines":[{"line_number":189,"context_line":"  these drivers."},{"line_number":190,"context_line":"- **Important \"documentation\" that isn\u0027t really documentation** - ``specs`` and"},{"line_number":191,"context_line":"  ``release notes`` are *NOT* documentation. A specification document is"},{"line_number":192,"context_line":"  written are to initiate a dialogue and gather feedback regarding the"},{"line_number":193,"context_line":"  design of a feature. Neither developers nor users will regard a"},{"line_number":194,"context_line":"  specification as official documentation after a feature has been"},{"line_number":195,"context_line":"  implemented. Release notes (:ref:`adding_release_notes`) allow for"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_b53bcdea","line":192,"in_reply_to":"9abb7d3a_dce4be0e","updated":"2016-05-29 15:08:29.000000000","message":"Done","commit_id":"67f1b1d7efa301b5a1a93d07b06ba65242ea84e3"},{"author":{"_account_id":14567,"name":"Rodrigo Barbieri","email":"rodrigo.barbieri2010@gmail.com","username":"ganso"},"change_message_id":"19bb6fbe5fc6ee237e34ac38b0ef5972fd9dcc96","unresolved":false,"context_lines":[{"line_number":132,"context_line":"  \u003chttp://docs.openstack.org/developer/manila/\u003e`_"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"OpenStack Security  Guide"},{"line_number":136,"context_line":"-------------------------"},{"line_number":137,"context_line":"- Any feature that has a security impact needs to be documented here."},{"line_number":138,"context_line":"- In general, administrators will follow the guidelines regarding best"}],"source_content_type":"text/x-rst","patch_set":9,"id":"9abb7d3a_d8794afe","line":135,"range":{"start_line":135,"start_character":18,"end_line":135,"end_character":20},"updated":"2016-05-30 13:24:36.000000000","message":"extra space here","commit_id":"c941941df6e512b25ea2b06639d62ce44b931c50"},{"author":{"_account_id":11865,"name":"Clinton Knight","email":"cknight@netapp.com","username":"cknight"},"change_message_id":"cf7c221197c51d3a086333bec14d095d361fd656","unresolved":false,"context_lines":[{"line_number":11,"context_line":"introducing new features and maintaining existing features. We ought to"},{"line_number":12,"context_line":"provide adequate documentation for the benefit of all kinds of audiences. The"},{"line_number":13,"context_line":"guidelines below will explain how you can document (or maintain"},{"line_number":14,"context_line":"documentation) for new (or existing) features and bug fixes in the core manila"},{"line_number":15,"context_line":"project and other projects that are part of the manila suite."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"9abb7d3a_b1eb8e77","line":14,"range":{"start_line":14,"start_character":13,"end_line":14,"end_character":18},"updated":"2016-05-31 13:31:25.000000000","message":"nit:  s/) for/ for)/","commit_id":"f749f0bf03577c8ac48987807f8dec7bea022720"},{"author":{"_account_id":6491,"name":"xing-yang","email":"xingyang105@gmail.com","username":"xing-yang"},"change_message_id":"a6ceeccefd6f86997bf1ea1a30fd649b160b9855","unresolved":false,"context_lines":[{"line_number":87,"context_line":"  \u003chttps://github.com/openstack/openstack-manuals\u003e`_. However, with the"},{"line_number":88,"context_line":"  Newton release, manila\u0027s install guide will live in its project tree."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":".. TODO(gouthamr): add actual links and repo instructions when available."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"OpenStack API Reference"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9abb7d3a_91166b53","line":90,"updated":"2016-05-31 01:07:00.000000000","message":"Why will the installation guide be in Manila tree while other guides are in openstack-manuals?","commit_id":"f749f0bf03577c8ac48987807f8dec7bea022720"},{"author":{"_account_id":16643,"name":"Goutham Pacha Ravi","email":"gouthampravi@gmail.com","username":"gouthamr"},"change_message_id":"88233a0477014b38b967e75b5893199011f6be1a","unresolved":false,"context_lines":[{"line_number":87,"context_line":"  \u003chttps://github.com/openstack/openstack-manuals\u003e`_. However, with the"},{"line_number":88,"context_line":"  Newton release, manila\u0027s install guide will live in its project tree."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":".. TODO(gouthamr): add actual links and repo instructions when available."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"OpenStack API Reference"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9abb7d3a_956f76c4","line":90,"in_reply_to":"9abb7d3a_91166b53","updated":"2016-05-31 01:09:30.000000000","message":"This was part of a recent install-guide team decision: \n\nhttp://git.openstack.org/cgit/openstack/docs-specs/tree/specs/newton/project-specific-installguides.rst","commit_id":"f749f0bf03577c8ac48987807f8dec7bea022720"}]}
