)]}'
{"guidelines/http.rst":[{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"622ca99498d1d0ead45b715100e717eb51c4c563","unresolved":false,"context_lines":[{"line_number":136,"context_line":"   OpenStack interoperability. There are two exceptions of this restriction:"},{"line_number":137,"context_line":"   The first one is that we find different code and try fixing it in the same"},{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_1a95a0e3","line":139,"updated":"2017-01-19 16:14:02.000000000","message":"This is not strictly true. There are clouds running via continuous delivery and we\u0027re generally supportive of that, so honestly once it\u0027s landed the assumption should be made that it\u0027s in production already.","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"97c28acbc6b13fdd7d347d6ff42effc4a0852dc2","unresolved":false,"context_lines":[{"line_number":136,"context_line":"   OpenStack interoperability. There are two exceptions of this restriction:"},{"line_number":137,"context_line":"   The first one is that we find different code and try fixing it in the same"},{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_6249925f","line":139,"in_reply_to":"5a3905b3_1a95a0e3","updated":"2017-01-19 18:36:16.000000000","message":"Yeah, I know such case.\nBut I feel it is hard to make a perfect code at once as human and I\u0027d like to get a chance for fixing it if we find issues in the same dev cycle.\n\nI think such users get benefit always from upstream, and it is reasonable that they need to get some demerit in the same time. We don\u0027t work only for them, and I hope providing better APIs as possible as a developer.","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":2,"name":"Monty Taylor","email":"mordred@inaugust.com","username":"mordred"},"change_message_id":"622ca99498d1d0ead45b715100e717eb51c4c563","unresolved":false,"context_lines":[{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_fa55341d","line":141,"updated":"2017-01-19 16:14:02.000000000","message":"I continue to be of the belief that microversions should not be used for this purpose. I\u0027ll argue with folks about it at the PTG though. (using microversions to add new functionality is great. Using it to make breaking changes means microversions are no longer microversions and are instead all major version bumps just called something else)","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e274ab527773d1396905d6f73b60311479a7e6ba","unresolved":false,"context_lines":[{"line_number":137,"context_line":"   The first one is that we find different code and try fixing it in the same"},{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_b32f80f5","line":141,"range":{"start_line":140,"start_character":17,"end_line":141,"end_character":21},"updated":"2017-01-19 02:11:54.000000000","message":"we should add API version-ing should be discoverable.\n\nThe second is that we fix/change the success code by bumping\n   a new API version which provides the mechanism of API change discover-ability. So that it can maintain interoperability.","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"bac44d788dbb6fadaf9488d7a55276935676f796","unresolved":false,"context_lines":[{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_3755cf1c","line":141,"in_reply_to":"5a3905b3_a2927649","updated":"2017-01-20 18:17:17.000000000","message":"Haha, microversions mechanism allows us status codes every day :-)","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":7350,"name":"Jordan Pittier","email":"jordan.pittier@gmail.com","username":"JordanP"},"change_message_id":"afa3b50ebb8d66247002f6c4fd22c591dfd2aece","unresolved":false,"context_lines":[{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_a2927649","line":141,"in_reply_to":"5a3905b3_a2a61abf","updated":"2017-01-20 10:07:31.000000000","message":"Yeah, but microversions are not free and backward compat is important. So we shouldn\"t send the message \"let\u0027s change status code every 2 weeks because we have microversions\".","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"97c28acbc6b13fdd7d347d6ff42effc4a0852dc2","unresolved":false,"context_lines":[{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_a2a61abf","line":141,"in_reply_to":"5a3905b3_fa55341d","updated":"2017-01-19 18:36:16.000000000","message":"To allow us backwards incompatible change is a big part of microversions. Most projects are already using microversions for that based on https://specs.openstack.org/openstack/nova-specs/specs/kilo/implemented/api-microversions.html#proposed-change","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e274ab527773d1396905d6f73b60311479a7e6ba","unresolved":false,"context_lines":[{"line_number":134,"context_line":"   However please do not change the existing success codes even if they are"},{"line_number":135,"context_line":"   different. The changes could cause backwards incompatibility and break the"},{"line_number":136,"context_line":"   OpenStack interoperability. There are two exceptions of this restriction:"},{"line_number":137,"context_line":"   The first one is that we find different code and try fixing it in the same"},{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"},{"line_number":145,"context_line":"~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_d3e6cce7","line":142,"range":{"start_line":137,"start_character":3,"end_line":142,"end_character":54},"updated":"2017-01-19 02:11:54.000000000","message":"it will be nice and clear if you can make these 2 options as list item.","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"},{"author":{"_account_id":7350,"name":"Jordan Pittier","email":"jordan.pittier@gmail.com","username":"JordanP"},"change_message_id":"afa3b50ebb8d66247002f6c4fd22c591dfd2aece","unresolved":false,"context_lines":[{"line_number":134,"context_line":"   However please do not change the existing success codes even if they are"},{"line_number":135,"context_line":"   different. The changes could cause backwards incompatibility and break the"},{"line_number":136,"context_line":"   OpenStack interoperability. There are two exceptions of this restriction:"},{"line_number":137,"context_line":"   The first one is that we find different code and try fixing it in the same"},{"line_number":138,"context_line":"   development cycle of the first API implementation. In this case, there are"},{"line_number":139,"context_line":"   no users who use the API and we can avoid backwards incompatibility in"},{"line_number":140,"context_line":"   actual world. The second is that we fix/change the success code by bumping"},{"line_number":141,"context_line":"   a new API version. Microversions allows us to do it easily, and a major"},{"line_number":142,"context_line":"   version bumping also is a good chance to change it."},{"line_number":143,"context_line":""},{"line_number":144,"context_line":"5xx Server Error Codes"},{"line_number":145,"context_line":"~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a3905b3_c2b062e0","line":142,"range":{"start_line":137,"start_character":3,"end_line":142,"end_character":54},"in_reply_to":"5a3905b3_d3e6cce7","updated":"2017-01-20 10:07:31.000000000","message":"+1","commit_id":"017af7fbd97ffefa8ee28c19bbffec4dd674a54f"}]}