)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"9ac51ae9a8e474554f849958a743ff188fc85e39","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"excceding the lendth hard-code limited by server code."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is hard-limit of the"},{"line_number":13,"context_line":"length of tags in server code."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":3,"id":"9af37de9_15044213","line":10,"updated":"2015-05-11 10:27:07.000000000","message":"length","commit_id":"9300aec7c1877dfec26a2207e6a97857340a10b6"},{"author":{"_account_id":14377,"name":"Apoorva","email":"apps.desh@gmail.com","username":"apoorvad"},"change_message_id":"8595e1c850db011f1be430d655e38435c7c2f4af","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"excceding the lendth hard-code limited by server code."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is hard-limit of the"},{"line_number":13,"context_line":"length of tags in server code."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":8,"id":"3afb71cf_75276bca","line":10,"updated":"2015-06-09 21:37:53.000000000","message":"s/excceding/exceeding\n\ns/lendth/length","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"b545a7ee79e9a408842babe6e2a110a6ac219551","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"excceding the lendth hard-code limited by server code."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is hard-limit of the"},{"line_number":13,"context_line":"length of tags in server code."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":8,"id":"fa32b979_e7cce28a","line":10,"in_reply_to":"3afb71cf_75276bca","updated":"2015-06-18 12:16:08.000000000","message":"Done","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"b0ea39a8b10242e4025ebf5a67fe5c4e846320b8","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"excceeding the limited length of collection type property."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is limit of the"},{"line_number":13,"context_line":"length of tags in server code."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":9,"id":"ba3cc151_d16caa9e","line":10,"updated":"2015-06-29 19:13:47.000000000","message":"change \"excceeding\" to \"exceeds\"","commit_id":"d30c65ca96034e961715e8338d6537bcddd613c5"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"9149e595890f5c18427eed5a1e391455e3041079","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Commit:     He Jie Xu \u003chejie.xu@intel.com\u003e"},{"line_number":5,"context_line":"CommitDate: 2015-07-21 14:44:56 +0800"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"exceeds the limited length of collection type property."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":14,"id":"1a4dcd0f_5ef771d4","line":7,"updated":"2015-08-13 16:30:48.000000000","message":"change \"have\" to \"has a\"\n\nchange \"hard-code\" to \"hard-coded\"","commit_id":"8e765741c06e3882d5a27e13f7d7ce3d78d8c61e"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"9149e595890f5c18427eed5a1e391455e3041079","unresolved":false,"context_lines":[{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"exceeds the limited length of collection type property."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is limit of the"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":14,"id":"1a4dcd0f_deb381eb","line":9,"updated":"2015-08-13 16:30:48.000000000","message":"change \"when the request with valid format\" to \"when the request format is valid\"","commit_id":"8e765741c06e3882d5a27e13f7d7ce3d78d8c61e"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"9149e595890f5c18427eed5a1e391455e3041079","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Clarify the return code when server have hard-code length limit"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"exceeds the limited length of collection type property."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is limit of the"},{"line_number":13,"context_line":"length of tags in server code."}],"source_content_type":"text/x-gerrit-commit-message","patch_set":14,"id":"1a4dcd0f_fe2e7d41","line":10,"updated":"2015-08-13 16:30:48.000000000","message":"What is a \"collection type property\"? Maybe this is supposed to be \"property that is a collection of items\"?\n\nChange \"limited length\" to \"maximum length\".\n\nChange \"request exceeds\" to \"the number of elements in the collection in the request body exceeds\"","commit_id":"8e765741c06e3882d5a27e13f7d7ce3d78d8c61e"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"9149e595890f5c18427eed5a1e391455e3041079","unresolved":false,"context_lines":[{"line_number":9,"context_line":"Clarify the case: when the request with valid format, but the request"},{"line_number":10,"context_line":"exceeds the limited length of collection type property."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is limit of the"},{"line_number":13,"context_line":"length of tags in server code."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Related patch: Ic1b2ecf9459798b14db12d449e003648c4228550"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":14,"id":"1a4dcd0f_5ecc518a","line":12,"updated":"2015-08-13 16:30:48.000000000","message":"change \"is limit of\" to \"is a limit to\"","commit_id":"8e765741c06e3882d5a27e13f7d7ce3d78d8c61e"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"9149e595890f5c18427eed5a1e391455e3041079","unresolved":false,"context_lines":[{"line_number":10,"context_line":"exceeds the limited length of collection type property."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"The instance of this case is tags. In nova there is limit of the"},{"line_number":13,"context_line":"length of tags in server code."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Related patch: Ic1b2ecf9459798b14db12d449e003648c4228550"},{"line_number":16,"context_line":""}],"source_content_type":"text/x-gerrit-commit-message","patch_set":14,"id":"1a4dcd0f_fea3ddaf","line":13,"updated":"2015-08-13 16:30:48.000000000","message":"remove \"in server code\" since it\u0027s irrelevant.","commit_id":"8e765741c06e3882d5a27e13f7d7ce3d78d8c61e"}],"guidelines/http.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"1b06d46571196d9e06d487f16fce3241af57d1e9","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* If the call with valid format results in excedding the length of request"},{"line_number":47,"context_line":"  which hard-code limited by server side, the return code should be"},{"line_number":48,"context_line":"  **403 Forbidden**. Do **not** use **400 BadRequest**. Because the server"},{"line_number":49,"context_line":"  understood the request, but the server is refusing to fulfill it for hard-"},{"line_number":50,"context_line":"  code limit of length."},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9af37de9_a73f9524","line":48,"updated":"2015-05-11 05:29:13.000000000","message":"Should this error response depend on hard-coded?\nIf the limit is configurable, it is not covered with this description?\nSo I feel \"hard-code\" is unnecessary.\n\nOne more thing is that this situation seems HTTP413 \"Request Entity Too Large\". Why should we use 403 instead of 413 here? Maybe we need the reason of not using 413 as the guideline.","commit_id":"a19a096fa498fbce0334906774861e39a0abba18"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"3d9cda4fb039fb4b44050927a6802c3574c1a94f","unresolved":false,"context_lines":[{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* If the call with valid format results in excedding the length of request"},{"line_number":47,"context_line":"  which hard-code limited by server side, the return code should be"},{"line_number":48,"context_line":"  **403 Forbidden**. Do **not** use **400 BadRequest**. Because the server"},{"line_number":49,"context_line":"  understood the request, but the server is refusing to fulfill it for hard-"},{"line_number":50,"context_line":"  code limit of length."},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9af37de9_62763b40","line":48,"in_reply_to":"9af37de9_a73f9524","updated":"2015-05-11 06:26:12.000000000","message":"Good point. It shouldn\u0027t depend on hard-code. \n\n413 as my understand is the whole request is too long. like we have too long request body. like the tags case. Maybe server only support two tags. The request body isn\u0027t too long.","commit_id":"a19a096fa498fbce0334906774861e39a0abba18"},{"author":{"_account_id":9420,"name":"Matthew Gilliard","email":"matthew.gilliard@hp.com","username":"gilliard"},"change_message_id":"c9b681a49f95ce36728a2bbb09e9b67482cd882e","unresolved":false,"context_lines":[{"line_number":43,"context_line":"  return code should be **403 Forbidden**. Do **not** use **413 Request"},{"line_number":44,"context_line":"  Entity Too Large**."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* If the call with valid format results in excedding the number of resources"},{"line_number":47,"context_line":"  which limited by server side code logic, the return code should be"},{"line_number":48,"context_line":"  **403 Forbidden**. Do **not** use **400 BadRequest**. Because server"},{"line_number":49,"context_line":"  understood the request, but the server is refusing to fulfill it for"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9af37de9_01b64c8a","line":46,"updated":"2015-05-11 08:36:17.000000000","message":"typo: exceeding\n\nI don\u0027t think the number of resources is a good phrase here. \"resource\" has a specific meaning in REST APIs, which this is not referring to.  Maybe use \"exceeding some limit which is set in server side logic (eg maximum field length)\" ?","commit_id":"9300aec7c1877dfec26a2207e6a97857340a10b6"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"643884369b3d155b479957de75f3c95d16360aaa","unresolved":false,"context_lines":[{"line_number":43,"context_line":"  return code should be **403 Forbidden**. Do **not** use **413 Request"},{"line_number":44,"context_line":"  Entity Too Large**."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* If the call with valid format results in excedding the number of resources"},{"line_number":47,"context_line":"  which limited by server side code logic, the return code should be"},{"line_number":48,"context_line":"  **403 Forbidden**. Do **not** use **400 BadRequest**. Because server"},{"line_number":49,"context_line":"  understood the request, but the server is refusing to fulfill it for"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9af37de9_24eefe22","line":46,"in_reply_to":"9af37de9_01b64c8a","updated":"2015-05-11 08:51:29.000000000","message":"\u0027length\u0027 always sounds like the length of string, actually there is many items.\n\nIf it is length of field....pretty sounds like invalid format. we should return 400 at here...","commit_id":"9300aec7c1877dfec26a2207e6a97857340a10b6"},{"author":{"_account_id":9420,"name":"Matthew Gilliard","email":"matthew.gilliard@hp.com","username":"gilliard"},"change_message_id":"c9b681a49f95ce36728a2bbb09e9b67482cd882e","unresolved":false,"context_lines":[{"line_number":48,"context_line":"  **403 Forbidden**. Do **not** use **400 BadRequest**. Because server"},{"line_number":49,"context_line":"  understood the request, but the server is refusing to fulfill it for"},{"line_number":50,"context_line":"  exceeding the number of resources can be processed. And also do **not** use"},{"line_number":51,"context_line":"  **413 Request Entity Too Large**, because the server only limits the number"},{"line_number":52,"context_line":"  of resource, not the request entity\u0027s length."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."}],"source_content_type":"text/x-rst","patch_set":3,"id":"9af37de9_e13fc8d4","line":51,"updated":"2015-05-11 08:36:17.000000000","message":"Again, it\u0027s not the number of \"resources\".  How about \"...the server only applied some limit to the values in the request, not the request entity\u0027s length\"?","commit_id":"9300aec7c1877dfec26a2207e6a97857340a10b6"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"b80217023b24116382edac6cc13d440c4d574f83","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"* If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjusts request and achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_71182385","line":51,"updated":"2015-05-14 20:38:43.000000000","message":"i think this would be clearer as \"...should adjust requests to achieve success.\"","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"71bdb716dc4fd34f07e0bc6b58eac85fe8ffcac4","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"* If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjusts request and achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_929f1203","line":51,"in_reply_to":"7a016987_71182385","updated":"2015-05-15 05:57:38.000000000","message":"Done","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"f7e44cc1a5a8f29e2eb108fa833cfc319e949619","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"* If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a016987_9f85c108","line":51,"updated":"2015-05-15 18:59:24.000000000","message":"Exceeding the limit of a collection type property is a specific case of the more general case of input validation. Can we generalize this first sentence to...\n\n    If the request fails input validation,  the return code should be **400 Bad Request**.\n\nDoes that make sense?","commit_id":"d2352fe01cb8bc71a94a15175c36fab804ade15e"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"9633f1d61c3ba97e21ab611009c256c1545b2c00","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"* If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a016987_017d39e7","line":51,"in_reply_to":"7a016987_9f85c108","updated":"2015-05-26 05:29:46.000000000","message":"Emm....if too generic that sounds no different with previous rule at line 46. This is rule explain for some specific case avoid confusing.","commit_id":"d2352fe01cb8bc71a94a15175c36fab804ade15e"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"f7e44cc1a5a8f29e2eb108fa833cfc319e949619","unresolved":false,"context_lines":[{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"},{"line_number":56,"context_line":"  request is not supported for that resource, the return code should be **405"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a016987_9f01416d","line":53,"updated":"2015-05-15 18:59:24.000000000","message":"The second sentence should be removed as the response code for quotas is already covered in the first bullet under Failure Codes. And this second sentence also seems to be in conflict with the first bullet point?\n\n    If the call results in the OpenStack user exceeding his or her quota, the return code should be **403 Forbidden**.\n\nvs\n\n    Do **not** use **403 Forbidden**, because this is different with quota case.","commit_id":"d2352fe01cb8bc71a94a15175c36fab804ade15e"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"9633f1d61c3ba97e21ab611009c256c1545b2c00","unresolved":false,"context_lines":[{"line_number":50,"context_line":"  should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"  client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"  Forbidden**, because this is different with quota case. For achieving"},{"line_number":53,"context_line":"  request success in quota case, it needs server side environment change."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"},{"line_number":56,"context_line":"  request is not supported for that resource, the return code should be **405"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7a016987_41733116","line":53,"in_reply_to":"7a016987_9f01416d","updated":"2015-05-26 05:29:46.000000000","message":"The second sentence is more explain why this do not use 403. I hope we have more word to explain why we think return this code rather than just a word we should use which status code. And it isn\u0027t in conflict with first point. Maybe I should say:\n\nDo **not** use **403 Forbidden** for this case, because this is different with exceeding quota.\n\nActually I want to say do not use 403 for exceeding limited length of collection type property.","commit_id":"d2352fe01cb8bc71a94a15175c36fab804ade15e"},{"author":{"_account_id":12321,"name":"Ryan Brown","email":"rybrown@redhat.com","username":"ryansb"},"change_message_id":"a1b448ec5cde69bf43c56effb59527d436e4486a","unresolved":false,"context_lines":[{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"    client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, it needs server side"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7a016987_8908272f","line":50,"updated":"2015-05-26 12:13:35.000000000","message":"I think this sentence would be a bit clearer as \"the return code should be **400 Bad Request** when the request exceeds the length limit\"","commit_id":"99b6f0fdc7fa4e83d50354a0a4003ee86d0c482c"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"d69679821759fcbbfcfbeaf395f2e151236d0164","unresolved":false,"context_lines":[{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"    client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, it needs server side"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7a016987_6a8cb67f","line":50,"in_reply_to":"7a016987_8908272f","updated":"2015-05-26 14:22:55.000000000","message":"Done","commit_id":"99b6f0fdc7fa4e83d50354a0a4003ee86d0c482c"},{"author":{"_account_id":12321,"name":"Ryan Brown","email":"rybrown@redhat.com","username":"ryansb"},"change_message_id":"a1b448ec5cde69bf43c56effb59527d436e4486a","unresolved":false,"context_lines":[{"line_number":50,"context_line":"    should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"    client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, it needs server side"},{"line_number":54,"context_line":"    environment change."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7a016987_1b08fe27","line":53,"updated":"2015-05-26 12:13:35.000000000","message":"\"the server-side environment must change\"","commit_id":"99b6f0fdc7fa4e83d50354a0a4003ee86d0c482c"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"d69679821759fcbbfcfbeaf395f2e151236d0164","unresolved":false,"context_lines":[{"line_number":50,"context_line":"    should be **400 Bad Request** when request exceeding limited length. The"},{"line_number":51,"context_line":"    client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, it needs server side"},{"line_number":54,"context_line":"    environment change."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7a016987_2a86be65","line":53,"in_reply_to":"7a016987_1b08fe27","updated":"2015-05-26 14:22:55.000000000","message":"Done","commit_id":"99b6f0fdc7fa4e83d50354a0a4003ee86d0c482c"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"0c6b9875cd3937ff7fb058ab9d3a735b6a3a7014","unresolved":false,"context_lines":[{"line_number":46,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."},{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_988eed77","line":49,"updated":"2015-06-16 21:33:00.000000000","message":"suggest reword to make this understandable:\n\n If the API limits the length of a property that is a collection (a list or object)","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"27c9ebf28c8e47c95f051328ca34b9efabe33f3b","unresolved":false,"context_lines":[{"line_number":46,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."},{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba3cc151_fdbbe073","line":49,"in_reply_to":"fa32b979_67a772bd","updated":"2015-06-29 08:05:20.000000000","message":"I didn\u0027t add (a list or object). I don\u0027t understand what the point of \u0027object\u0027, a object based on collection?","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"b545a7ee79e9a408842babe6e2a110a6ac219551","unresolved":false,"context_lines":[{"line_number":46,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."},{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_67a772bd","line":49,"in_reply_to":"fa32b979_988eed77","updated":"2015-06-18 12:16:08.000000000","message":"Done","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":330,"name":"John Dickinson","email":"me@not.mn","username":"notmyname"},"change_message_id":"610ebc0a775c57d3d6f7a02458943dc13d352f6d","unresolved":false,"context_lines":[{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_00a43e05","line":50,"updated":"2015-06-18 17:18:46.000000000","message":"When the request exceeds the length limit? Or when the response exceeds the limit (or would have exceeded the limit)?\n\n\nCurrently Swift returns 400 if a user sends an account, container, or object create request with an invalid (including too long) name. However, if a user sends a listing request but asks for more items than the max page limit, Swift returns a 412.","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"27c9ebf28c8e47c95f051328ca34b9efabe33f3b","unresolved":false,"context_lines":[{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba3cc151_5d4becb0","line":50,"in_reply_to":"fa32b979_00a43e05","updated":"2015-06-29 08:05:20.000000000","message":"This is for \"Currently Swift returns 400 if a user sends an account, container, or object create request with an invalid (including too long) name. \"","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"0c6b9875cd3937ff7fb058ab9d3a735b6a3a7014","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_d8c6b599","line":51,"updated":"2015-06-16 21:33:00.000000000","message":"This could also make it clear that the client shouldn\u0027t expect to repeat the request and have it work.","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"b545a7ee79e9a408842babe6e2a110a6ac219551","unresolved":false,"context_lines":[{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_87f15697","line":51,"in_reply_to":"fa32b979_d8c6b599","updated":"2015-06-18 12:16:08.000000000","message":"Done","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"0c6b9875cd3937ff7fb058ab9d3a735b6a3a7014","unresolved":false,"context_lines":[{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_b8b97117","line":52,"updated":"2015-06-16 21:33:00.000000000","message":"change \"different with\" to \"different than\"","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"b545a7ee79e9a408842babe6e2a110a6ac219551","unresolved":false,"context_lines":[{"line_number":49,"context_line":"  * If API limits the length of collection type property, the return code"},{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_e7f6228e","line":52,"in_reply_to":"fa32b979_b8b97117","updated":"2015-06-18 12:16:08.000000000","message":"Done","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"0c6b9875cd3937ff7fb058ab9d3a735b6a3a7014","unresolved":false,"context_lines":[{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_38448119","line":53,"updated":"2015-06-16 21:33:00.000000000","message":"Change \"For achieving\" to \"To achieve\"\n\nChange \"in quota\" to \"in the quota\" (add the)\n\nAlso, suggest put this in () and not a separate sentence since it\u0027s referring to the previous sentence and not to the topic of the paragraph.","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"b545a7ee79e9a408842babe6e2a110a6ac219551","unresolved":false,"context_lines":[{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_47634e42","line":53,"in_reply_to":"fa32b979_38448119","updated":"2015-06-18 12:16:08.000000000","message":"Sorry, I didn\u0027t get your last word?\n\none mean is change last sentence as \"To achieve request success in the quota case the server-side environment\"?","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"ca3338fef1cf41c917d6a61677bdc1b5d282a360","unresolved":false,"context_lines":[{"line_number":50,"context_line":"    should be **400 Bad Request** when the request exceeds the length limit."},{"line_number":51,"context_line":"    The client should adjust requests to achieve success. Do **not** use **403"},{"line_number":52,"context_line":"    Forbidden** for this case, because this is different with exceeding quota."},{"line_number":53,"context_line":"    For achieving request success in quota case, the server-side environment"},{"line_number":54,"context_line":"    must change."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"* If a call is made to a known resource URI, but the HTTP method used for the"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_38d0a8c8","line":53,"in_reply_to":"fa32b979_47634e42","updated":"2015-06-18 14:07:16.000000000","message":"Here\u0027s my suggested wording for the last sentence:\n\n (For a subsequent request to succeed when quotas are exceeded the\n server environment must change.)\n\nAlternatively, don\u0027t make this a separate sentence...\n\n because this is different with exceeding quota -- for a subsequent request to\n succeed when quotas are exceeded the server environment must change.","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"95131c8f3412adfe8c41fe7a64a53d51cb5f3d3c","unresolved":false,"context_lines":[{"line_number":46,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."},{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of a property that is a collection, the return"},{"line_number":50,"context_line":"    code should be **400 Bad Request** when the request exceeds the length"},{"line_number":51,"context_line":"    limit. The client should adjust requests to achieve success, and shouldn\u0027t"},{"line_number":52,"context_line":"    expect to repeat the request and have it work. Do **not** use"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba3cc151_54dcfee3","line":49,"updated":"2015-06-30 00:34:50.000000000","message":"s/If API/If the API/","commit_id":"171080a1d7d9b450383742d3a86da4b637b2fca9"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"eda557e9a6741e33410a302412429e99ca7e3633","unresolved":false,"context_lines":[{"line_number":46,"context_line":"* For badly formatted requests, the return code should be **400 Bad Request**."},{"line_number":47,"context_line":"  Do **not** use **422 Unprocessable Entity**."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"  * If API limits the length of a property that is a collection, the return"},{"line_number":50,"context_line":"    code should be **400 Bad Request** when the request exceeds the length"},{"line_number":51,"context_line":"    limit. The client should adjust requests to achieve success, and shouldn\u0027t"},{"line_number":52,"context_line":"    expect to repeat the request and have it work. Do **not** use"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba3cc151_9872b4e4","line":49,"in_reply_to":"ba3cc151_54dcfee3","updated":"2015-06-30 05:46:45.000000000","message":"Done","commit_id":"171080a1d7d9b450383742d3a86da4b637b2fca9"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"b56a2898d9b1487ddd8557e6192d6824b8d9ef1d","unresolved":false,"context_lines":[{"line_number":98,"context_line":"    limit. The client should adjust requests to achieve success, and shouldn\u0027t"},{"line_number":99,"context_line":"    expect to repeat the request and have it work. Do **not** use"},{"line_number":100,"context_line":"    **403 Forbidden** for this case, because this is different than exceeding"},{"line_number":101,"context_line":"    quota -- for a subsequent request to succeed when quotas are excceded the"},{"line_number":102,"context_line":"    server environment must change."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"* If a request is made to a known resource URI, but the HTTP method used for"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_bf09e585","line":101,"updated":"2015-07-09 18:29:14.000000000","message":"s/excceded/exceeded,/","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ea76cb42e6f9d02e64d6a8cd6c22440a82c41c61","unresolved":false,"context_lines":[{"line_number":98,"context_line":"    limit. The client should adjust requests to achieve success, and shouldn\u0027t"},{"line_number":99,"context_line":"    expect to repeat the request and have it work. Do **not** use"},{"line_number":100,"context_line":"    **403 Forbidden** for this case, because this is different than exceeding"},{"line_number":101,"context_line":"    quota -- for a subsequent request to succeed when quotas are excceded the"},{"line_number":102,"context_line":"    server environment must change."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"* If a request is made to a known resource URI, but the HTTP method used for"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_aa20b0b1","line":101,"in_reply_to":"ba3cc151_bf09e585","updated":"2015-07-16 05:17:50.000000000","message":"Done","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":261,"name":"Salvatore Orlando","email":"salv.orlando@gmail.com","username":"salvatore-orlando"},"change_message_id":"ee2150a143621f9dbc83fd1969e3d162e775babc","unresolved":false,"context_lines":[{"line_number":99,"context_line":"    expect to repeat the request and have it work. Do **not** use"},{"line_number":100,"context_line":"    **403 Forbidden** for this case, because this is different than exceeding"},{"line_number":101,"context_line":"    quota -- for a subsequent request to succeed when quotas are excceded the"},{"line_number":102,"context_line":"    server environment must change."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"* If a request is made to a known resource URI, but the HTTP method used for"},{"line_number":105,"context_line":"  the request is not supported for that resource, the return code should be"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_c705f779","line":102,"updated":"2015-07-09 22:32:18.000000000","message":"should there be an exception when said property is actually subject to quota checks?\n\nFor instance Neutron applies some sort of quota checks to subnet prefixes in a subnet pool (http://git.openstack.org/cgit/openstack/neutron/tree/neutron/api/v2/attributes.py#n823).\n\nThe differences are:\n1) the request might then succeed if conditions on the server side change\n2) success or failure of the request depend on the limits which have been specified for the particular tenant","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ea76cb42e6f9d02e64d6a8cd6c22440a82c41c61","unresolved":false,"context_lines":[{"line_number":99,"context_line":"    expect to repeat the request and have it work. Do **not** use"},{"line_number":100,"context_line":"    **403 Forbidden** for this case, because this is different than exceeding"},{"line_number":101,"context_line":"    quota -- for a subsequent request to succeed when quotas are excceded the"},{"line_number":102,"context_line":"    server environment must change."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"* If a request is made to a known resource URI, but the HTTP method used for"},{"line_number":105,"context_line":"  the request is not supported for that resource, the return code should be"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_1dd32461","line":102,"in_reply_to":"ba3cc151_c705f779","updated":"2015-07-16 05:17:50.000000000","message":"We shouldn\u0027t say it is an exception, it belong to line 89?","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"}],"guidelines/tags.rst":[{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"b80217023b24116382edac6cc13d440c4d574f83","unresolved":false,"context_lines":[{"line_number":124,"context_line":"        \"tags\": [\u0027foo\u0027, \u0027baz\u0027, \u0027qux\u0027]"},{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeding the API allowed in adding request, the"},{"line_number":128,"context_line":"return code should be **400 Bad Request** as the HTTP Guidelines described."},{"line_number":129,"context_line":"To achieving request success, client should change the requested number of"},{"line_number":130,"context_line":"tags less than API limited."}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_f46881bc","line":127,"updated":"2015-05-14 20:38:43.000000000","message":"i think this would be clearer as, \"If the number of tags exceeds the limit allowed by the API, the return code....\"","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"71bdb716dc4fd34f07e0bc6b58eac85fe8ffcac4","unresolved":false,"context_lines":[{"line_number":124,"context_line":"        \"tags\": [\u0027foo\u0027, \u0027baz\u0027, \u0027qux\u0027]"},{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeding the API allowed in adding request, the"},{"line_number":128,"context_line":"return code should be **400 Bad Request** as the HTTP Guidelines described."},{"line_number":129,"context_line":"To achieving request success, client should change the requested number of"},{"line_number":130,"context_line":"tags less than API limited."}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_b2f32e73","line":127,"in_reply_to":"7a016987_f46881bc","updated":"2015-05-15 05:57:38.000000000","message":"Done","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"b80217023b24116382edac6cc13d440c4d574f83","unresolved":false,"context_lines":[{"line_number":127,"context_line":"If the number of tags exceeding the API allowed in adding request, the"},{"line_number":128,"context_line":"return code should be **400 Bad Request** as the HTTP Guidelines described."},{"line_number":129,"context_line":"To achieving request success, client should change the requested number of"},{"line_number":130,"context_line":"tags less than API limited."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Deleting Tags"},{"line_number":133,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_d4ac65ef","line":130,"updated":"2015-05-14 20:38:43.000000000","message":"likewise, this would be clearer as \"To achieve request success, the client should change the requested number of tags to be less than the API limit.\"","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"71bdb716dc4fd34f07e0bc6b58eac85fe8ffcac4","unresolved":false,"context_lines":[{"line_number":127,"context_line":"If the number of tags exceeding the API allowed in adding request, the"},{"line_number":128,"context_line":"return code should be **400 Bad Request** as the HTTP Guidelines described."},{"line_number":129,"context_line":"To achieving request success, client should change the requested number of"},{"line_number":130,"context_line":"tags less than API limited."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Deleting Tags"},{"line_number":133,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":5,"id":"7a016987_92e8327e","line":130,"in_reply_to":"7a016987_d4ac65ef","updated":"2015-05-15 05:57:38.000000000","message":"Done","commit_id":"9e422fc8b1fee9bdfbee436d96a4649579d4219d"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"7747657eaebc672b65fe090e04d2e99d2b287d94","unresolved":false,"context_lines":[{"line_number":118,"context_line":"        \"tags\": [\u0027foo\u0027, \u0027baz\u0027, \u0027qux\u0027]"},{"line_number":119,"context_line":"    }"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"Response::"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"    {"},{"line_number":124,"context_line":"        \"tags\": [\u0027foo\u0027, \u0027baz\u0027, \u0027qux\u0027]"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fa32b979_fb7b7326","line":121,"updated":"2015-06-16 22:08:53.000000000","message":"This should say \"Example successful response::\"\n\nAnd add\n\n 200 OK\n\nbefore the entity-body.","commit_id":"5d08f08b57455288935662d1c6121ccffe461439"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"b56a2898d9b1487ddd8557e6192d6824b8d9ef1d","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_5fde99da","line":128,"updated":"2015-07-09 18:29:14.000000000","message":"s/described/describe/","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":261,"name":"Salvatore Orlando","email":"salv.orlando@gmail.com","username":"salvatore-orlando"},"change_message_id":"ee2150a143621f9dbc83fd1969e3d162e775babc","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_87804fc0","line":128,"in_reply_to":"ba3cc151_5fde99da","updated":"2015-07-09 22:32:18.000000000","message":"or \"as mandated by HTTP guidelines\"?\n\nmeh, it\u0027s not really important imho","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ea76cb42e6f9d02e64d6a8cd6c22440a82c41c61","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_bd5558c3","line":128,"in_reply_to":"ba3cc151_87804fc0","updated":"2015-07-16 05:17:50.000000000","message":"emm....why not \u0027described\u0027.... describe is verb.","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"b56a2898d9b1487ddd8557e6192d6824b8d9ef1d","unresolved":false,"context_lines":[{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than API limit."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Deleting Tags"},{"line_number":133,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_5f4779a2","line":130,"updated":"2015-07-09 18:29:14.000000000","message":"s/API/the API/","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ea76cb42e6f9d02e64d6a8cd6c22440a82c41c61","unresolved":false,"context_lines":[{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than API limit."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Deleting Tags"},{"line_number":133,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba3cc151_fd5be0f7","line":130,"in_reply_to":"ba3cc151_5f4779a2","updated":"2015-07-16 05:17:50.000000000","message":"ok...this word I copy from other\u0027s comment...","commit_id":"0861ec0220a6d0e739fb044d0ff6041073c0b9d4"},{"author":{"_account_id":10215,"name":"Peter Stachowski","email":"peter@tesora.com","username":"peterstac"},"change_message_id":"9f6b3b0da3ea85291c65202e3b9cdf6862209f85","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than the API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":13,"id":"9a41bdd9_1f0243b5","line":128,"updated":"2015-07-16 14:08:11.000000000","message":"Since the guidelines are still active, present tense would make more sense.  No biggie though.","commit_id":"f224cf430f586ad9c25e62aab8f755d7afa98a7b"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"9c3ec92a586ac0656e5f70942c04ff7c7d30d6c0","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than the API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":13,"id":"3a50d1a3_37036a0f","line":128,"in_reply_to":"9a41bdd9_1f0243b5","updated":"2015-07-20 22:01:27.000000000","message":"+1","commit_id":"f224cf430f586ad9c25e62aab8f755d7afa98a7b"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"3a9898b619ca7dde71c8aa35d188089bd6322c94","unresolved":false,"context_lines":[{"line_number":125,"context_line":"    }"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"If the number of tags exceeds the limit allowed by the API, the return code"},{"line_number":128,"context_line":"should be **400 Bad Request** as the HTTP Guidelines described. To achieve"},{"line_number":129,"context_line":"request success, the client should change the requested number of tags to"},{"line_number":130,"context_line":"be less than the API limit."},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":13,"id":"3a50d1a3_60d7df23","line":128,"in_reply_to":"9a41bdd9_1f0243b5","updated":"2015-07-21 06:35:45.000000000","message":"Thanks, I see now","commit_id":"f224cf430f586ad9c25e62aab8f755d7afa98a7b"}]}