)]}'
{"doc/source/usage.rst":[{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c2d8f8a9ee2156fd3091ceba7adf1c5d1308314d","unresolved":false,"context_lines":[{"line_number":187,"context_line":""},{"line_number":188,"context_line":"The ``rest_status_code`` stanza is how you can show what HTTP status codes your"},{"line_number":189,"context_line":"API uses and what they indicate"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":".. code-block:: rst"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"   .. rest_status_code:: \u003csucess|failure\u003e \u003clocation of status.yaml file\u003e"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_bfe80b18","line":190,"updated":"2016-07-15 16:03:12.000000000","message":"Suggest to move the comment from line 268 (publishing tables explanation) to here. This stanza creates two tables for status codes grouped by success and errors. Status codes and descriptions are defined in a yaml file. \n\nAn idea: Could the data in the status code files include the type of the status code (error or success) so that there is one file and no need to set that attribute in the rst?","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c2d8f8a9ee2156fd3091ceba7adf1c5d1308314d","unresolved":false,"context_lines":[{"line_number":194,"context_line":""},{"line_number":195,"context_line":"This stanza should be the first element after the narrative section of the"},{"line_number":196,"context_line":"method description."},{"line_number":197,"context_line":""},{"line_number":198,"context_line":"An example from the Designate documentation is:"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":".. code-block:: rst"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_1fc15781","line":197,"updated":"2016-07-15 16:03:12.000000000","message":"Not sure the order matters, though.","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"a134f8969813a7c3ad17ba10c59fb529b9d4f8b9","unresolved":false,"context_lines":[{"line_number":194,"context_line":""},{"line_number":195,"context_line":"This stanza should be the first element after the narrative section of the"},{"line_number":196,"context_line":"method description."},{"line_number":197,"context_line":""},{"line_number":198,"context_line":"An example from the Designate documentation is:"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":".. code-block:: rst"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_d4dcc11a","line":197,"in_reply_to":"fad55976_1fc15781","updated":"2016-07-15 17:00:45.000000000","message":"It was more to make sure that the layout is consistent for all api docs","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c2d8f8a9ee2156fd3091ceba7adf1c5d1308314d","unresolved":false,"context_lines":[{"line_number":282,"context_line":""},{"line_number":283,"context_line":"In this case, adding a entry at the same level as the ``default`` and"},{"line_number":284,"context_line":"referencing that in the stanaza like so:"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":".. code-block:: yaml"},{"line_number":287,"context_line":""},{"line_number":288,"context_line":"   - 409: duplcate_zone"}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_c4dc121b","line":285,"updated":"2016-07-15 16:03:12.000000000","message":"stanza","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c2d8f8a9ee2156fd3091ceba7adf1c5d1308314d","unresolved":false,"context_lines":[{"line_number":286,"context_line":".. code-block:: yaml"},{"line_number":287,"context_line":""},{"line_number":288,"context_line":"   - 409: duplcate_zone"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"This will overide the default message with the newly defined one."},{"line_number":291,"context_line":""},{"line_number":292,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_7f34d3dd","line":289,"updated":"2016-07-15 16:03:12.000000000","message":"So duplcate_zone is a lookup key for another definition of this status code.\nCould I set the status code description here in the rst file as,\n- 409: |\n    duplicate zone text","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"a134f8969813a7c3ad17ba10c59fb529b9d4f8b9","unresolved":false,"context_lines":[{"line_number":286,"context_line":".. code-block:: yaml"},{"line_number":287,"context_line":""},{"line_number":288,"context_line":"   - 409: duplcate_zone"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"This will overide the default message with the newly defined one."},{"line_number":291,"context_line":""},{"line_number":292,"context_line":""}],"source_content_type":"text/x-rst","patch_set":9,"id":"fad55976_34a0bd90","line":289,"in_reply_to":"fad55976_7f34d3dd","updated":"2016-07-15 17:00:45.000000000","message":"We initially did that, but was asked to move it to a yaml file.\n\nI think having one way of doing it is better, and the yaml file is a better place for long descriptions","commit_id":"fa30156fd6ae5840c9f6dfccb5e76f35189b0aa0"}],"os_api_ref/http_codes.py":[{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"a6d3a7777c7a19d45f6f412fbd4e395120df5154","unresolved":false,"context_lines":[{"line_number":45,"context_line":"        501: \"Not Implemented\","},{"line_number":46,"context_line":"        502: \"Bad Gateway\","},{"line_number":47,"context_line":"        503: \"Service Unavailable\","},{"line_number":48,"context_line":"        504: \"Gateway Timeout\","},{"line_number":49,"context_line":"    }"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"    def run(self):"}],"source_content_type":"text/x-python","patch_set":1,"id":"bab6814e_c8a51e05","line":48,"updated":"2016-05-18 20:04:00.000000000","message":"Asking for understanding -- are these the defaults, and then if there\u0027s different text in the RST, then the extension uses the text from the RST instead of these defaults? Want to make sure I know what people will need to change in their RST source to get these.","commit_id":"4741fb97946ff3f463398574cd8b325bd76382ac"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"f8f35617e5571ba404d37213aa52d16d28f96a0a","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"    status_types \u003d (\"success\", \"error\")"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"    CODES \u003d {"},{"line_number":30,"context_line":"        200: \"OK\","},{"line_number":31,"context_line":"        201: \"Created\","},{"line_number":32,"context_line":"        202: \"Accepted\","}],"source_content_type":"text/x-python","patch_set":2,"id":"bab6814e_61fd6bb0","line":29,"updated":"2016-05-23 18:05:17.000000000","message":"I wonder whether it would be worth making a copy of the httplib.responses dict instead of rolling your own?  The advantage is that you\u0027d get automatic updates if new status codes were approved; on the other hand, that doesn\u0027t seem to happen very often.\n\nActually, it\u0027s probably better if you roll your own here, because otherwise we can\u0027t have openstack-specific codes (like if we wanted all services to return 420 in some situation).  Sorry I brought it up.","commit_id":"649996e6837dba5ad5700e5015bd7cda49270b0f"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"1da87140da33d3cb59f8a326bb52688eb3b8cd47","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"    status_types \u003d (\"success\", \"error\")"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"    CODES \u003d {"},{"line_number":30,"context_line":"        200: \"OK\","},{"line_number":31,"context_line":"        201: \"Created\","},{"line_number":32,"context_line":"        202: \"Accepted\","}],"source_content_type":"text/x-python","patch_set":2,"id":"bab6814e_0ba200ae","line":29,"in_reply_to":"bab6814e_61fd6bb0","updated":"2016-05-26 18:16:32.000000000","message":"Nope, you are right. I took the httplib dict, and then allowed us to add some custom ones. - good call.","commit_id":"649996e6837dba5ad5700e5015bd7cda49270b0f"}]}