)]}'
{"api-ref/source/parameters.yaml":[{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":2041,"context_line":"  description: |"},{"line_number":2042,"context_line":"    The status of this API version. This can be one of:"},{"line_number":2043,"context_line":""},{"line_number":2044,"context_line":"    - ``CURRENT``: this is the prefered version of the API to use"},{"line_number":2045,"context_line":"    - ``SUPPORTED``: this is an older, but still supported version of the API"},{"line_number":2046,"context_line":"    - ``DEPRECATED``: a deprecated version of the API that is slated for removal"},{"line_number":2047,"context_line":"virtual_interfaces:"}],"source_content_type":"text/x-yaml","patch_set":4,"id":"1a122d0e_ebbe47d3","line":2044,"range":{"start_line":2044,"start_character":31,"end_line":2044,"end_character":39},"updated":"2016-04-15 15:19:38.000000000","message":"preferred","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"ac29282f7f1397bc74dfea95ec61244f36f60a2d","unresolved":false,"context_lines":[{"line_number":2010,"context_line":"  in: body"},{"line_number":2011,"context_line":"  required: true"},{"line_number":2012,"context_line":"  description: \u003e"},{"line_number":2013,"context_line":"    A list of version objects that describe the API versions available"},{"line_number":2014,"context_line":"version_id:"},{"line_number":2015,"context_line":"  type: string"},{"line_number":2016,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":8,"id":"1a122d0e_a268e9bb","line":2013,"range":{"start_line":2013,"start_character":68,"end_line":2013,"end_character":70},"updated":"2016-04-15 18:43:49.000000000","message":"nit: need to put \".\" at the end.","commit_id":"fbe373ac733f3ed985da6552d3c796925b5f2c52"}],"api-ref/source/versions.inc":[{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":15,"context_line":""},{"line_number":16,"context_line":"Normal response codes: 200,300"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400),"},{"line_number":19,"context_line":"unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Request"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_2b731fb3","side":"PARENT","line":18,"updated":"2016-04-15 15:19:38.000000000","message":"Why not list the errors? Because they are so numerous it almost doesn\u0027t matter?\n\nAlso, isn\u0027t it possible that the deployment disables version discovery so you can\u0027t even use this? I thought we were working around that in novaclient because of Rackspace and some others. I\u0027m not sure if that\u0027s worth noting or not.","commit_id":"95264623262694ec3c16e39f3c32e32ea48b5663"},{"author":{"_account_id":2750,"name":"Sean Dague","email":"sean@dague.net","username":"sdague"},"change_message_id":"d453f41caa2b8fd5afd45ca27a3a94272aa4c1e3","unresolved":false,"context_lines":[{"line_number":15,"context_line":""},{"line_number":16,"context_line":"Normal response codes: 200,300"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400),"},{"line_number":19,"context_line":"unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Request"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_2b72ffe5","side":"PARENT","line":18,"in_reply_to":"1a122d0e_2b731fb3","updated":"2016-04-15 15:32:30.000000000","message":"Almost all of these errors can\u0027t happen. We can revisit the errors that can later. This is never turned off. The route that is often blanked is the api specific one.","commit_id":"95264623262694ec3c16e39f3c32e32ea48b5663"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"In order to bring new features to users over time, the Nova API"},{"line_number":11,"context_line":"supports versioning. There are 2 kinds of versions in Nova \u0027\u0027major"},{"line_number":12,"context_line":"versions\u0027\u0027 as defined by dedicated urls. There are also"},{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_e8e12dd2","line":11,"range":{"start_line":11,"start_character":31,"end_line":11,"end_character":32},"updated":"2016-04-15 15:19:38.000000000","message":"s/2/two/ is probably more appropriate for a user doc. I seem to be scarred for stuff like this from a previous project I was on where numbers \u003c10 in docs needed to be spelled out.","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"In order to bring new features to users over time, the Nova API"},{"line_number":11,"context_line":"supports versioning. There are 2 kinds of versions in Nova \u0027\u0027major"},{"line_number":12,"context_line":"versions\u0027\u0027 as defined by dedicated urls. There are also"},{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_a8ef35af","line":11,"range":{"start_line":11,"start_character":54,"end_line":11,"end_character":58},"updated":"2016-04-15 15:19:38.000000000","message":"s/in Nova/in Nova:/","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"In order to bring new features to users over time, the Nova API"},{"line_number":11,"context_line":"supports versioning. There are 2 kinds of versions in Nova \u0027\u0027major"},{"line_number":12,"context_line":"versions\u0027\u0027 as defined by dedicated urls. There are also"},{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."},{"line_number":15,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_8826b914","line":12,"range":{"start_line":11,"start_character":59,"end_line":12,"end_character":10},"updated":"2016-04-15 15:19:38.000000000","message":"Is \u0027\u0027major versions\u0027\u0027 meant for emphasis because it doesn\u0027t emphasize it. Or did you just mean to use double-quotes instead of two single-quotes? Or am I being pedantic?","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":11,"context_line":"supports versioning. There are 2 kinds of versions in Nova \u0027\u0027major"},{"line_number":12,"context_line":"versions\u0027\u0027 as defined by dedicated urls. There are also"},{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. TODO(sdague): build a more detailed link to using Microversions on"},{"line_number":17,"context_line":"   requests."}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_28ede58b","line":14,"range":{"start_line":14,"start_character":2,"end_line":14,"end_character":23},"updated":"2016-04-15 15:19:38.000000000","message":"It\u0027s actually X-OpenStack-Nova-API-Version","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. TODO(sdague): build a more detailed link to using Microversions on"},{"line_number":17,"context_line":"   requests."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"List All Major Versions"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_a8f9f54f","line":16,"updated":"2016-04-15 15:19:38.000000000","message":"Could we link to http://developer.openstack.org/api-guide/compute/microversions.html for more detail? Or does that defeat the purpose of this?","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":2750,"name":"Sean Dague","email":"sean@dague.net","username":"sdague"},"change_message_id":"d453f41caa2b8fd5afd45ca27a3a94272aa4c1e3","unresolved":false,"context_lines":[{"line_number":13,"context_line":"\u0027\u0027microversions\u0027\u0027 which can be requested through use of the"},{"line_number":14,"context_line":"``OpenStack-API-Version`` header."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. TODO(sdague): build a more detailed link to using Microversions on"},{"line_number":17,"context_line":"   requests."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"List All Major Versions"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_4b9f7b03","line":16,"in_reply_to":"1a122d0e_a8f9f54f","updated":"2016-04-15 15:32:30.000000000","message":"I think we need something a bit more dedicated here.","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":22,"context_line":".. rest_method:: GET /"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"This fetches all the information about all known major API versions in"},{"line_number":25,"context_line":"the deployment. For each API version links to more specific"},{"line_number":26,"context_line":"information will be provided, as well as information about supported"},{"line_number":27,"context_line":"min and max microversions."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"Normal Response Codes: 200, 300"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_885eb943","line":26,"range":{"start_line":25,"start_character":16,"end_line":26,"end_character":28},"updated":"2016-04-15 15:19:38.000000000","message":"This is a bit hard to parse, I\u0027d suggest re-wording as:\n\n\"Links to more specific information will be provided for each API version, as well as...\"","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ab02908b22d2032b0de199dcb56b2895f6cd7818","unresolved":false,"context_lines":[{"line_number":82,"context_line":"Response"},{"line_number":83,"context_line":"--------"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"  - x-openstack-request-id: x-openstack-request-id"},{"line_number":88,"context_line":"  - version: version"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_6b1d170f","line":85,"updated":"2016-04-15 15:19:38.000000000","message":"There is a \u0027media-types\u0027 field in the response example that\u0027s not described here.","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":2750,"name":"Sean Dague","email":"sean@dague.net","username":"sdague"},"change_message_id":"d453f41caa2b8fd5afd45ca27a3a94272aa4c1e3","unresolved":false,"context_lines":[{"line_number":82,"context_line":"Response"},{"line_number":83,"context_line":"--------"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"  - x-openstack-request-id: x-openstack-request-id"},{"line_number":88,"context_line":"  - version: version"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_ab556f1e","line":85,"in_reply_to":"1a122d0e_6b1d170f","updated":"2016-04-15 15:32:30.000000000","message":"There is, it\u0027s pretty vestigial, and not described in the current site at all either - http://developer.openstack.org/api-ref-compute-v2.1.html which only describes the x-openstack-request-id.","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"4a7ff0b1312c50afabbb081e1dd59927a177dfbb","unresolved":false,"context_lines":[{"line_number":82,"context_line":"Response"},{"line_number":83,"context_line":"--------"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"  - x-openstack-request-id: x-openstack-request-id"},{"line_number":88,"context_line":"  - version: version"}],"source_content_type":"text/x-c++src","patch_set":4,"id":"1a122d0e_8edb61ed","line":85,"in_reply_to":"1a122d0e_ab556f1e","updated":"2016-04-15 15:41:53.000000000","message":"Maybe note it\u0027s vestigial like the \u0027updated\u0027 parameter?","commit_id":"940a1e4a7c59d94bfef7d304f9d9a9b012da9939"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"0eb0135c7e6029f3847270e0226d71d02865a38b","unresolved":false,"context_lines":[{"line_number":10,"context_line":"In order to bring new features to users over time, the Nova API"},{"line_number":11,"context_line":"supports versioning. There are two kinds of versions in Nova."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"- \u0027\u0027major versions\u0027\u0027, which have dedicate urls"},{"line_number":14,"context_line":"- \u0027\u0027microversions\u0027\u0027, which can be requested through the use of the"},{"line_number":15,"context_line":"  ``X-OpenStack-Nova-API-Version`` header"},{"line_number":16,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":5,"id":"1a122d0e_8e02413d","line":13,"range":{"start_line":13,"start_character":33,"end_line":13,"end_character":41},"updated":"2016-04-15 15:44:22.000000000","message":"dedicated","commit_id":"8adfa533e0b8497b6ac6b074fa46cd3ab5fcee5a"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"0eb0135c7e6029f3847270e0226d71d02865a38b","unresolved":false,"context_lines":[{"line_number":83,"context_line":"Response"},{"line_number":84,"context_line":"--------"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"  - x-openstack-request-id: x-openstack-request-id"},{"line_number":89,"context_line":"  - version: version"}],"source_content_type":"text/x-c++src","patch_set":5,"id":"1a122d0e_ceaa7919","line":86,"updated":"2016-04-15 15:44:22.000000000","message":"As noted in the last patch set, we could add a note about \u0027media-types\u0027 being vestigial like you have for \u0027updated\u0027 above. I guess I\u0027ll leave that up to you though. It just seems weird to have it in the example and not describe it. Personally I\u0027d note it and say it\u0027s vestigial or remove it from the example.","commit_id":"8adfa533e0b8497b6ac6b074fa46cd3ab5fcee5a"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"2949dd34a9f83330528c0405fc7f2d2f77f877df","unresolved":false,"context_lines":[{"line_number":95,"context_line":""},{"line_number":96,"context_line":".. note::"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"   The ``updated`` and ``media_types`` parameter in the response is"},{"line_number":99,"context_line":"   vestigial and provides no useful information. They will probably be"},{"line_number":100,"context_line":"   deprecated and removed in the future."},{"line_number":101,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":6,"id":"1a122d0e_d9cb611d","line":98,"range":{"start_line":98,"start_character":25,"end_line":98,"end_character":36},"updated":"2016-04-15 16:01:39.000000000","message":"Technically it\u0027s \u0027media-types\u0027 with a dash.","commit_id":"62ab670b89c0c1a3929691072ca287c8e9c4ca27"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"1867da1f0605672f82760c056c103d048a98508f","unresolved":false,"context_lines":[{"line_number":95,"context_line":""},{"line_number":96,"context_line":".. note::"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"   The ``updated`` and ``media-types`` parameter in the response is"},{"line_number":99,"context_line":"   vestigial and provides no useful information. They will probably be"},{"line_number":100,"context_line":"   deprecated and removed in the future."},{"line_number":101,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":7,"id":"1a122d0e_d4e168d2","line":98,"range":{"start_line":98,"start_character":39,"end_line":98,"end_character":48},"updated":"2016-04-15 16:18:58.000000000","message":"parameters","commit_id":"8dce50832aed0fc8c4da1650b7be8435155a06e2"}]}