)]}'
{"doc/source/contributor/api-ref-guideline.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"b82f064eb5609f4ac63c2caafa72392a7197f8d5","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f769fc5_1a73a782","line":174,"range":{"start_line":174,"start_character":4,"end_line":174,"end_character":9},"updated":"2018-12-25 22:12:47.000000000","message":"This \"e.g.\" seems unnecessary.","commit_id":"43327398406d3b167b685334a1436e08b3164be9"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"eb6adb7a9dddc2087d3c38c6bc08af5278c03c28","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f769fc5_4eae44e8","line":174,"range":{"start_line":174,"start_character":4,"end_line":174,"end_character":9},"in_reply_to":"1f769fc5_1a73a782","updated":"2018-12-26 02:57:46.000000000","message":"It is necessary because this sentence applies only to some APIs.","commit_id":"43327398406d3b167b685334a1436e08b3164be9"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"bb8032cad2ab306769a92a8063afbbafc9e75a35","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1f769fc5_98bc9a6a","line":174,"range":{"start_line":174,"start_character":4,"end_line":174,"end_character":9},"in_reply_to":"1f769fc5_4eae44e8","updated":"2018-12-26 23:04:11.000000000","message":"Does it mean this should not be applied to the other APIs which have created_at or id?","commit_id":"43327398406d3b167b685334a1436e08b3164be9"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"3eb9e5406ff5946834be5cb3742f9b24750d293d","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"}],"source_content_type":"text/x-rst","patch_set":1,"id":"dfd5e7cf_ee5076d7","line":174,"range":{"start_line":174,"start_character":4,"end_line":174,"end_character":9},"in_reply_to":"1f769fc5_98bc9a6a","updated":"2019-01-07 05:48:04.000000000","message":"No.\nIt means that this cannot be applied to the other APIs which does not have created_at and id in its response.\n\nFor example, List Keypairs (GET /os-keypairs) does not have created_at and id in its response. So they are not sorted by id and created_at.","commit_id":"43327398406d3b167b685334a1436e08b3164be9"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"d1557211434f72d8a8ba7bd26ea9ef278cac5a1c","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9fdfeff1_e50dde37","line":175,"range":{"start_line":174,"start_character":1,"end_line":175,"end_character":35},"updated":"2019-01-22 05:53:45.000000000","message":"I think we need be clear only if those fields exists\nand seems code doesn\u0027t always sort in this order?\n\nI know this is an example but a little bit confusing to a developer who is not familiar with nova api..","commit_id":"bc77c475dec60f0f3f41f3389e2ae5bc33d707e4"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"798cf31dd9ad3479d2dc5f4a2205b3004234697c","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9fdfeff1_6a9c3f5d","line":175,"range":{"start_line":174,"start_character":1,"end_line":175,"end_character":35},"in_reply_to":"9fdfeff1_1cbce6da","updated":"2019-01-23 08:28:52.000000000","message":"`id` is an internal field which not expose to the end user.","commit_id":"bc77c475dec60f0f3f41f3389e2ae5bc33d707e4"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"07580435aa3e67e899a2cc8f2aa535f7483dbed2","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9fdfeff1_1196dbf1","line":175,"range":{"start_line":174,"start_character":1,"end_line":175,"end_character":35},"in_reply_to":"9fdfeff1_6a9c3f5d","updated":"2019-01-25 08:54:42.000000000","message":"For example, the response of \"List Migrations\" (os-migrations) API has both \u0027id\u0027 and \u0027created_at\u0027.\n\nhttps://developer.openstack.org/api-ref/compute/?expanded\u003dlist-migrations-detail#id327\n\n\u003e e.g. The response is sorted by ``created_at`` and ``id``\n\u003e    in descending order by default.\n\nIt is just an example.\nIt cannot apply for other APIs necessarily.","commit_id":"bc77c475dec60f0f3f41f3389e2ae5bc33d707e4"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"dbf931f0f51a2a062cdcb920b27eaebc02a17497","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"* Sort order of response results"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":175,"context_line":"    in descending order by default."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"* Policy"},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9fdfeff1_1cbce6da","line":175,"range":{"start_line":174,"start_character":1,"end_line":175,"end_character":35},"in_reply_to":"9fdfeff1_e50dde37","updated":"2019-01-22 22:58:20.000000000","message":"Yeah, that is right.\nIf this is just for such developers only, it is not worth as a guideline.","commit_id":"bc77c475dec60f0f3f41f3389e2ae5bc33d707e4"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"0147ee3a3645c895678e66a44dea00caeaacad91","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":166,"context_line":"    in descending order by default."},{"line_number":167,"context_line":""},{"line_number":168,"context_line":"* Policy"},{"line_number":169,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"5fc1f717_2a9eabb8","line":166,"range":{"start_line":165,"start_character":1,"end_line":166,"end_character":35},"updated":"2019-03-15 00:34:56.000000000","message":"I agree with the previous comment about not exposing these as these are not always the case for all APIs.\n\n* Sort order of response results\n\n  - More information about sorting order of response results.","commit_id":"3a88670803205b816b20844e79a8b9eb5b70249e"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"5518826e0f75d06895a5c53a819473eb5ec22c5b","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - e.g. The response is sorted by ``created_at`` and ``id``"},{"line_number":166,"context_line":"    in descending order by default."},{"line_number":167,"context_line":""},{"line_number":168,"context_line":"* Policy"},{"line_number":169,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"5fc1f717_2abf8bd1","line":166,"range":{"start_line":165,"start_character":1,"end_line":166,"end_character":35},"in_reply_to":"5fc1f717_2a9eabb8","updated":"2019-03-15 01:03:03.000000000","message":"Done","commit_id":"3a88670803205b816b20844e79a8b9eb5b70249e"},{"author":{"_account_id":15888,"name":"Zhenyu Zheng","email":"zheng.zhenyu@outlook.com","username":"Kevin_Zheng"},"change_message_id":"88d7f54e777a8e9d2464cffa3dcf66515f9d7bab","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_5292cd4d","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"updated":"2019-03-15 08:52:46.000000000","message":"Sorry, I don\u0027t quite get what this means, is this something like find more information about sort order in some reference?","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"6de264a9570bfa193dd2b3e4cdf46c0e09b877e5","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_f8e4aa3e","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"in_reply_to":"5fc1f717_3d022440","updated":"2019-03-20 00:45:36.000000000","message":"Ghanshyam,\n\n \u003e So the line \u0027More information about sorting order of\n \u003e response results.\u0027 convey that as api-ref file you can\n \u003e add more information about sort order of response at this place.\n\nHumm, I still don\u0027t get the point..\nDevelopers can add more information about sort order, but what kind of information should they add actually?\nCan we say\n\n - Describe sorting order of response results if the API\n   implements the order (e.g. The response is sorted by\n   ``created_at`` and ``id`` in descending order by default)\n\n?","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"2b37d37d21e57bf2f9b13ba3e29ae6f23a0a117a","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_578b96c1","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"in_reply_to":"5fc1f717_5292cd4d","updated":"2019-03-15 15:33:40.000000000","message":"this is the template not specific doc, so this says the heading \u0027Sort order of response results\u0027 and what all details we need to write under this heading. Which is more information about sorting order which is API specific?","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"f3d876d886f656bbc102425d6f0b484ee175e37c","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_daca0619","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"in_reply_to":"5fc1f717_578b96c1","updated":"2019-03-19 23:03:17.000000000","message":"I\u0027m also confused.. This is just TODO for our future work?","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"1c8b06549462d32284a70def2ea88c49eb2271f9","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_3d022440","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"in_reply_to":"5fc1f717_daca0619","updated":"2019-03-20 00:14:36.000000000","message":"ok, let me clarify it. api-ref-guideline.rst file is just a reference template for developer who will write the .inc file for api-ref. \n\nWe have been following the consistency and best practice for building the api-ref and this is the guide or we can say template which describes those consistencies and best practice. If any new member who introduce new API and so write the api-ref for that API, can refer this guide and understand what all sections and information he/she needs to add.\n\nSo the line \u0027More information about sorting order of response results.\u0027 convey that as api-ref file you can add more information about sort order of response at this place.\n\nThis is same like \u0027Behavior\u0027, \u0027Policy\u0027 section","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"4eb0814af61a5b07622c871f6d62c347ae0be81f","unresolved":false,"context_lines":[{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* Sort order of response results"},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"  - More information about sorting order of response results."},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"* Policy"},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5fc1f717_481371b9","line":165,"range":{"start_line":165,"start_character":3,"end_line":165,"end_character":61},"in_reply_to":"5fc1f717_f8e4aa3e","updated":"2019-03-22 06:33:49.000000000","message":"Done","commit_id":"fd7613972ff57224395d42b03dd9816a177c431a"}]}