)]}'
{"specs/approved/bump-minimum-microversion-to-1.6.rst":[{"author":{"_account_id":23883,"name":"Joanna Taryma","email":"joanna.taryma@intel.com","username":"jtaryma"},"change_message_id":"3418002a9177853fe359cdd2a0b9724a7ba0b752","unresolved":false,"context_lines":[{"line_number":168,"context_line":"The ``next_min_version`` header is added to the response body of a ``GET /``"},{"line_number":169,"context_line":"request, and is set to \"1.6\" for Pike."},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"The minimum supported microversion is raised in Queens to 1.6."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"Client (CLI) impact"},{"line_number":174,"context_line":"-------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3a1ff146_41b8f8e5","line":171,"updated":"2017-03-15 21:39:06.000000000","message":"Maybe 1 sentence about raising Unsupported Version exception in case of using \u003c1.6?","commit_id":"2116642649c0ee8c854890a98b3f8dbe0e5fcb81"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"a81e9aaf581153716f76d8f0df5e0055464d11b4","unresolved":false,"context_lines":[{"line_number":168,"context_line":"The ``next_min_version`` header is added to the response body of a ``GET /``"},{"line_number":169,"context_line":"request, and is set to \"1.6\" for Pike."},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"The minimum supported microversion is raised in Queens to 1.6."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"Client (CLI) impact"},{"line_number":174,"context_line":"-------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3a1ff146_8c3dc4bd","line":171,"in_reply_to":"3a1ff146_41b8f8e5","updated":"2017-03-15 23:08:17.000000000","message":"+1, I should add something about this, probably specify that we 406 in this case. Will do tomorrow. Thanks!","commit_id":"2116642649c0ee8c854890a98b3f8dbe0e5fcb81"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"a65f639e7e4270ead2452f634cad07178659bf08","unresolved":false,"context_lines":[{"line_number":68,"context_line":"      }"},{"line_number":69,"context_line":"    ]"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"We will add a ``next_min_version`` field to this document, so that it will look"},{"line_number":72,"context_line":"like::"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"    \"versions\": ["}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_da6ce89e","line":71,"updated":"2017-03-17 17:47:22.000000000","message":"I don\u0027t find this one particularly useful and/or informative - please see my comments on the api-wg spec","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"e5de3d8665bebf9d008fbac873f8758f9c8faca3","unresolved":false,"context_lines":[{"line_number":68,"context_line":"      }"},{"line_number":69,"context_line":"    ]"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"We will add a ``next_min_version`` field to this document, so that it will look"},{"line_number":72,"context_line":"like::"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"    \"versions\": ["}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ff52f3f_ad302409","line":71,"in_reply_to":"1a1ced50_176764eb","updated":"2017-04-13 11:00:08.000000000","message":"for other things we deprecate, we usually add the release when the removal will happen to some message, why not do the same here?","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"5b85d54c096d54acdc17df107580f3e3626acf86","unresolved":false,"context_lines":[{"line_number":68,"context_line":"      }"},{"line_number":69,"context_line":"    ]"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"We will add a ``next_min_version`` field to this document, so that it will look"},{"line_number":72,"context_line":"like::"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"    \"versions\": ["}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_176764eb","line":71,"in_reply_to":"1a1ced50_4af15c6a","updated":"2017-03-23 16:24:50.000000000","message":"/me keeps this conversation in the other spec\n\nFor those following along, the api-wg spec is here: https://review.openstack.org/#/c/446138/","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":13295,"name":"Mario Villaplana","email":"mario.villaplana@gmail.com","username":"mariojv"},"change_message_id":"0012cb942fcf4e6fe7409e9758d7cb774c9d1e09","unresolved":false,"context_lines":[{"line_number":68,"context_line":"      }"},{"line_number":69,"context_line":"    ]"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"We will add a ``next_min_version`` field to this document, so that it will look"},{"line_number":72,"context_line":"like::"},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"    \"versions\": ["}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_4af15c6a","line":71,"in_reply_to":"1a1ced50_da6ce89e","updated":"2017-03-22 22:09:45.000000000","message":"I haven\u0027t thought about it a lot, but I think I agree.\n\nIf I saw this in some API, I\u0027d probably just ignore it since I don\u0027t have any information about *when* the min API version will be bumped immediately available.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"a65f639e7e4270ead2452f634cad07178659bf08","unresolved":false,"context_lines":[{"line_number":109,"context_line":"In Pike, we\u0027ll also need to:"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"* Update our CLI and python SDK to read this new field, and issue a warning if"},{"line_number":112,"context_line":"  the user requests a deprecated version."},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"* Update any code we use to talk to the API (e.g. devstack) to use version"},{"line_number":115,"context_line":"  1.6 or newer."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_fa69a48c","line":112,"updated":"2017-03-17 17:47:22.000000000","message":"CLI - yes, python SDK - not sure. This way we will issue warning on users, while we need to reach out to developers. Dunno how to handle it (see also my comments on the api-wg spec).","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":13295,"name":"Mario Villaplana","email":"mario.villaplana@gmail.com","username":"mariojv"},"change_message_id":"0012cb942fcf4e6fe7409e9758d7cb774c9d1e09","unresolved":false,"context_lines":[{"line_number":109,"context_line":"In Pike, we\u0027ll also need to:"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"* Update our CLI and python SDK to read this new field, and issue a warning if"},{"line_number":112,"context_line":"  the user requests a deprecated version."},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"* Update any code we use to talk to the API (e.g. devstack) to use version"},{"line_number":115,"context_line":"  1.6 or newer."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_ca61cc06","line":112,"in_reply_to":"1a1ced50_f9dd3171","updated":"2017-03-22 22:09:45.000000000","message":"I do think we need to warn with the SDK too, even if it\u0027s just a log message somewhere.\n\nThere will almost certainly be folks using the SDK who we\u0027ll miss with any outreach despite our best efforts. Having it in the code increases the probability that they\u0027ll learn about the change.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"1570a294a896753150c192d462a55b69db5ad36e","unresolved":false,"context_lines":[{"line_number":109,"context_line":"In Pike, we\u0027ll also need to:"},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"* Update our CLI and python SDK to read this new field, and issue a warning if"},{"line_number":112,"context_line":"  the user requests a deprecated version."},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"* Update any code we use to talk to the API (e.g. devstack) to use version"},{"line_number":115,"context_line":"  1.6 or newer."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_f9dd3171","line":112,"in_reply_to":"1a1ced50_fa69a48c","updated":"2017-03-17 18:44:48.000000000","message":"I still think we should - the users can either file bugs or find a new application to use if the app is no longer supported. Or maybe just do the upgrade they\u0027ve been neglecting. If we don\u0027t warn, it\u0027ll just break with no notice.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"a65f639e7e4270ead2452f634cad07178659bf08","unresolved":false,"context_lines":[{"line_number":130,"context_line":""},{"line_number":131,"context_line":"* Mark code to handle versions less than 1.6 to be removed later, after we can"},{"line_number":132,"context_line":"  collect some user feedback on the change. We don\u0027t remove it right away so"},{"line_number":133,"context_line":"  that we can easily put the versions back if this turns out to be a mistake."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"* Update our API version history documentation[2] to indicate what is now"},{"line_number":136,"context_line":"  unsupported."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_1a05a0c1","line":133,"updated":"2017-03-17 17:47:22.000000000","message":"we can just do \"git revert\". why leave the code?","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"1570a294a896753150c192d462a55b69db5ad36e","unresolved":false,"context_lines":[{"line_number":130,"context_line":""},{"line_number":131,"context_line":"* Mark code to handle versions less than 1.6 to be removed later, after we can"},{"line_number":132,"context_line":"  collect some user feedback on the change. We don\u0027t remove it right away so"},{"line_number":133,"context_line":"  that we can easily put the versions back if this turns out to be a mistake."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"* Update our API version history documentation[2] to indicate what is now"},{"line_number":136,"context_line":"  unsupported."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_993c3d95","line":133,"in_reply_to":"1a1ced50_1a05a0c1","updated":"2017-03-17 18:44:48.000000000","message":"Well, it will probably take 1-3 cycles to get proper feedback on this. We may end up introducing many conflicts over that time. I\u0027d rather just leave it there.\n\nThat said, I\u0027m not opposed to \"git revert\" being the rollback plan, but I don\u0027t want to be the one to do it. :)","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"5b85d54c096d54acdc17df107580f3e3626acf86","unresolved":false,"context_lines":[{"line_number":130,"context_line":""},{"line_number":131,"context_line":"* Mark code to handle versions less than 1.6 to be removed later, after we can"},{"line_number":132,"context_line":"  collect some user feedback on the change. We don\u0027t remove it right away so"},{"line_number":133,"context_line":"  that we can easily put the versions back if this turns out to be a mistake."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"* Update our API version history documentation[2] to indicate what is now"},{"line_number":136,"context_line":"  unsupported."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_0c24bbc4","line":133,"in_reply_to":"1a1ced50_652c8b99","updated":"2017-03-23 16:24:50.000000000","message":"Yes, I would of course mark it. :)","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":13295,"name":"Mario Villaplana","email":"mario.villaplana@gmail.com","username":"mariojv"},"change_message_id":"0012cb942fcf4e6fe7409e9758d7cb774c9d1e09","unresolved":false,"context_lines":[{"line_number":130,"context_line":""},{"line_number":131,"context_line":"* Mark code to handle versions less than 1.6 to be removed later, after we can"},{"line_number":132,"context_line":"  collect some user feedback on the change. We don\u0027t remove it right away so"},{"line_number":133,"context_line":"  that we can easily put the versions back if this turns out to be a mistake."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"* Update our API version history documentation[2] to indicate what is now"},{"line_number":136,"context_line":"  unsupported."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_652c8b99","line":133,"in_reply_to":"1a1ced50_993c3d95","updated":"2017-03-22 22:09:45.000000000","message":"I like the \"git revert\" rollback plan personally. :)\n\nIf we do end up leaving the code, let\u0027s at least mark when we should remove it, so it doesn\u0027t hang around forever for no reason (R cycle?)","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":13295,"name":"Mario Villaplana","email":"mario.villaplana@gmail.com","username":"mariojv"},"change_message_id":"0012cb942fcf4e6fe7409e9758d7cb774c9d1e09","unresolved":false,"context_lines":[{"line_number":151,"context_line":"Go above 1.11 for the new minimum. This would be a more interesting experiment,"},{"line_number":152,"context_line":"but we must assume some users will miss the notification and the new field,"},{"line_number":153,"context_line":"and we want the change to be a fairly soft landing for those users."},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"Data model impact"},{"line_number":156,"context_line":"-----------------"},{"line_number":157,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_2546134f","line":154,"updated":"2017-03-22 22:09:45.000000000","message":"We could also make a new major version and eventually set v1 up for deprecation. I suppose that\u0027s essentially the same thing, just on a longer timeframe.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":10343,"name":"Jim Rollenhagen","email":"jim@jimrollenhagen.com","username":"jimrollenhagen"},"change_message_id":"5b85d54c096d54acdc17df107580f3e3626acf86","unresolved":false,"context_lines":[{"line_number":151,"context_line":"Go above 1.11 for the new minimum. This would be a more interesting experiment,"},{"line_number":152,"context_line":"but we must assume some users will miss the notification and the new field,"},{"line_number":153,"context_line":"and we want the change to be a fairly soft landing for those users."},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"Data model impact"},{"line_number":156,"context_line":"-----------------"},{"line_number":157,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a1ced50_972434b3","line":154,"in_reply_to":"1a1ced50_2546134f","updated":"2017-03-23 16:24:50.000000000","message":"I no longer believe that\u0027s a workable alternative. Keystone did this with v2 to v3, and has been working on moving people to v3 for years and years now. Same for glance with v1 to v2, though they\u0027ve been maintaining both for years and still can\u0027t deprecate v1 due to lack of feature(s) in v2.\n\nI think incremental change is the way to go here.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"e5de3d8665bebf9d008fbac873f8758f9c8faca3","unresolved":false,"context_lines":[{"line_number":172,"context_line":""},{"line_number":173,"context_line":"After the minimum is raised, requests for versions older than 1.6 will return"},{"line_number":174,"context_line":"a 406 Not Acceptable error code, with a body conforming to the API Working"},{"line_number":175,"context_line":"Group guidelines.[1]"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Client (CLI) impact"},{"line_number":178,"context_line":"-------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9ff52f3f_51cb7252","line":175,"updated":"2017-04-13 11:00:08.000000000","message":"the problem is, the guideline specified the \"detail\" field to be used for the human-readable string of the error. We already have two places where it can be returned, and it\u0027s going to be third one (eg https://review.openstack.org/#/c/364566/4/ironicclient/common/http.py). OTOH, depending this spec on the error codes cleanup will slow it down significantly, so not sure what\u0027s the best way here.","commit_id":"a010445f5348f8e94fd1fed6082f089b755e2a00"}]}
