)]}'
{"api-guide/source/microversions.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"c29b779865e5eee90dade30e049f8f0de7be627a","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":15,"context_line":"Microversions"},{"line_number":16,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_dfeae80e","line":16,"updated":"2015-12-08 02:29:20.000000000","message":"nit: one \"\u003d\" should be removed.","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":15,"context_line":"Microversions"},{"line_number":16,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_b30f1338","line":16,"in_reply_to":"7a740942_dfeae80e","updated":"2015-12-08 05:20:25.000000000","message":"Done","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"c29b779865e5eee90dade30e049f8f0de7be627a","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_9fc78097","line":20,"updated":"2015-12-08 02:29:20.000000000","message":"How about\n\n ... keeps the old versions\u0027\n behaviors for backwards compatibility, so ...","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d081c3dcbe25b40bf10d696ab3166c8cce92bb8d","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_aec7a896","line":20,"in_reply_to":"7a740942_2e32d8f2","updated":"2015-12-08 05:24:01.000000000","message":"ok, gmann\u0027s one is better.","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_2e32d8f2","line":20,"in_reply_to":"7a740942_9fc78097","updated":"2015-12-08 05:20:25.000000000","message":"@Ken\u0027ichi, \"behaviors\" is just part of API. we have input/output format also. So we shouldn\u0027t only talk about behaviors. Does make sense?","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e834402aa9c95ebc4b6b55964444c9c92dff2587","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_e22dc746","line":20,"in_reply_to":"7a740942_9fc78097","updated":"2015-12-08 02:59:32.000000000","message":"in addition for more clarity, we can say something \"If cloud is upgraded to support newer versions, it will still support all older versions to maintain the backward compatibility for users using older versions.\"","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_8e674ce8","line":20,"in_reply_to":"7a740942_e22dc746","updated":"2015-12-08 05:20:25.000000000","message":"@Ghanshyam, thanks, \u0027all older versions\u0027 sounds better.","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"c29b779865e5eee90dade30e049f8f0de7be627a","unresolved":false,"context_lines":[{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"There are multiple cases which you can resolve with Microversions:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_df38a8a2","line":21,"updated":"2015-12-08 02:29:20.000000000","message":"s/discovers/discover/","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":18,"context_line":"API v2.1 supports Microversions. User uses Microversions to discover the"},{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"There are multiple cases which you can resolve with Microversions:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_ae5488fd","line":21,"in_reply_to":"7a740942_df38a8a2","updated":"2015-12-08 05:20:25.000000000","message":"Done","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"c29b779865e5eee90dade30e049f8f0de7be627a","unresolved":false,"context_lines":[{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"There are multiple cases which you can resolve with Microversions:"},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_7f4ad427","line":22,"updated":"2015-12-08 02:29:20.000000000","message":"s/takes/take/","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"e841964a0ccf2ab136d9d810ea9b827be701bdb1","unresolved":false,"context_lines":[{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"There are multiple cases which you can resolve with Microversions:"},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_6edf8069","line":22,"in_reply_to":"7a740942_0e7b5c8d","updated":"2015-12-08 05:23:33.000000000","message":"there are \"can\" before \"takes\".\nso need to use \"take\" after \"can\".","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":19,"context_line":"supported API version in the cloud. Microversions always keeps the old version"},{"line_number":20,"context_line":"backward compatible, so user\u0027s client code is never broken by the cloud with"},{"line_number":21,"context_line":"new version development. Also user can discovers new features easily with"},{"line_number":22,"context_line":"Microversions, then user can takes all the advantages of current cloud."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"There are multiple cases which you can resolve with Microversions:"},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_0e7b5c8d","line":22,"in_reply_to":"7a740942_7f4ad427","updated":"2015-12-08 05:20:25.000000000","message":"the \u0027user\u0027 is singular， so we should use \u0027takes\u0027?","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e834402aa9c95ebc4b6b55964444c9c92dff2587","unresolved":false,"context_lines":[{"line_number":27,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":30,"context_line":"with legacy v2 API. The legacy v2 API user is never worry about that his old"},{"line_number":31,"context_line":"client is broken with new cloud deployment. Cloud operator won\u0027t worry about"},{"line_number":32,"context_line":"upgrading his deployment will broken the user with old client."},{"line_number":33,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_a2b1ff02","line":30,"updated":"2015-12-08 02:59:32.000000000","message":"his/her","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"c29b779865e5eee90dade30e049f8f0de7be627a","unresolved":false,"context_lines":[{"line_number":27,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":30,"context_line":"with legacy v2 API. The legacy v2 API user is never worry about that his old"},{"line_number":31,"context_line":"client is broken with new cloud deployment. Cloud operator won\u0027t worry about"},{"line_number":32,"context_line":"upgrading his deployment will broken the user with old client."},{"line_number":33,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_1f0150af","line":30,"updated":"2015-12-08 02:29:20.000000000","message":"s/is never/don\u0027t need to/","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":27,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":30,"context_line":"with legacy v2 API. The legacy v2 API user is never worry about that his old"},{"line_number":31,"context_line":"client is broken with new cloud deployment. Cloud operator won\u0027t worry about"},{"line_number":32,"context_line":"upgrading his deployment will broken the user with old client."},{"line_number":33,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_ce70f4a6","line":30,"in_reply_to":"7a740942_a2b1ff02","updated":"2015-12-08 05:20:25.000000000","message":"Done","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e834402aa9c95ebc4b6b55964444c9c92dff2587","unresolved":false,"context_lines":[{"line_number":29,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":30,"context_line":"with legacy v2 API. The legacy v2 API user is never worry about that his old"},{"line_number":31,"context_line":"client is broken with new cloud deployment. Cloud operator won\u0027t worry about"},{"line_number":32,"context_line":"upgrading his deployment will broken the user with old client."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"TODO: add more use-cases for Microversions"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_22c66f68","line":32,"updated":"2015-12-08 02:59:32.000000000","message":"how about something below-\n\nCloud operator don\u0027t need to worry that upgrading Cloud to newer version will break  any user with old client.","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"70b6f94780ca6ebfe6cc6491003d88f9426af06c","unresolved":false,"context_lines":[{"line_number":29,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":30,"context_line":"with legacy v2 API. The legacy v2 API user is never worry about that his old"},{"line_number":31,"context_line":"client is broken with new cloud deployment. Cloud operator won\u0027t worry about"},{"line_number":32,"context_line":"upgrading his deployment will broken the user with old client."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"TODO: add more use-cases for Microversions"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7a740942_aea248fa","line":32,"in_reply_to":"7a740942_22c66f68","updated":"2015-12-08 05:20:25.000000000","message":"thanks, your words sounds better.","commit_id":"9e4ada5013fd6698160bad2d8e8a807aaa1cd8f4"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"ff700505e54237a53b8e36e5ddf69ef12bb71f4c","unresolved":false,"context_lines":[{"line_number":25,"context_line":"There are multiple cases which you can resolve with Microversions:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Legacy v2 API user with new cloud"},{"line_number":28,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"The minimum version of Microversions is `2.1`, this is a version compatible"},{"line_number":31,"context_line":"with legacy v2 API. The legacy v2 API user don\u0027t need to worry about that his"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_f9f6cb5b","line":28,"updated":"2015-12-08 12:00:50.000000000","message":"Nit, I prefer using \u003d\u003d\u003d as the next level.","commit_id":"50aa74f91d5c58dbbb95c4f1ab1faf239203f05d"}]}