)]}'
{"api-guide/source/server_concepts.rst":[{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"a1af74a3ea72178c236da066dd770b900d2a5848","unresolved":false,"context_lines":[{"line_number":252,"context_line":"   **Example: Query server using regex matching on name**"},{"line_number":253,"context_line":""},{"line_number":254,"context_line":".. code::"},{"line_number":255,"context_line":"   Precondition:"},{"line_number":256,"context_line":"   Request with administrator context:"},{"line_number":257,"context_line":"   GET /servers/detail"},{"line_number":258,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af94dfe_9228ea34","side":"PARENT","line":255,"range":{"start_line":255,"start_character":3,"end_line":255,"end_character":16},"updated":"2016-03-18 13:52:36.000000000","message":"The word \"Precondition\" got lost sometimes. Was this by mistake or with intention?","commit_id":"3ad46e3c7888f533745d4ba71fd3d4095d24e242"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"a1af74a3ea72178c236da066dd770b900d2a5848","unresolved":false,"context_lines":[{"line_number":169,"context_line":""},{"line_number":170,"context_line":"   **Example: General user query server with administrator only options**"},{"line_number":171,"context_line":""},{"line_number":172,"context_line":"   Request with non-administrator context:"},{"line_number":173,"context_line":"        GET /servers/detail?locked\u003d1"},{"line_number":174,"context_line":""},{"line_number":175,"context_line":"   Note that \u0027locked\u0027 is not returned through the API layer"},{"line_number":176,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af94dfe_7d8b6f1f","line":173,"range":{"start_line":172,"start_character":0,"end_line":173,"end_character":36},"updated":"2016-03-18 13:52:36.000000000","message":"The spacing is used for definition lists [1]. You\u0027ll notice that \"Request with non-administrator context:\" is rendered with bold font, although you didn\u0027t use ** to mark it as bold font. Not sure if this was you\u0027re intention. This should be:\n\n    Request with non-administrator context: ``GET /servers/detail?locked\u003d1``\n\n[1] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#definition-lists","commit_id":"00d6b82abbbd52ab723dd961466fb084426082ef"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"a1af74a3ea72178c236da066dd770b900d2a5848","unresolved":false,"context_lines":[{"line_number":176,"context_line":""},{"line_number":177,"context_line":"   .. code:: JSON"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"        Response: {"},{"line_number":180,"context_line":"            \"servers\": ["},{"line_number":181,"context_line":"            {"},{"line_number":182,"context_line":"                \"name\": \"t1\","}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af94dfe_9d70fba5","line":179,"range":{"start_line":179,"start_character":8,"end_line":179,"end_character":16},"updated":"2016-03-18 13:52:36.000000000","message":"After double-checking [1] and other *.rst files in this folder, I think \"Response:\" should never be used in this document. That\u0027s no valid JSON. I didn\u0027t see that when I opened the bug report.\n\n[1] http://developer.openstack.org/api-ref-compute-v2.1.html#showServer","commit_id":"00d6b82abbbd52ab723dd961466fb084426082ef"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"a1af74a3ea72178c236da066dd770b900d2a5848","unresolved":false,"context_lines":[{"line_number":250,"context_line":"            }"},{"line_number":251,"context_line":"            ]"},{"line_number":252,"context_line":"        }"},{"line_number":253,"context_line":"   "},{"line_number":254,"context_line":"   **Example: Query server using regex matching on name**"},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"   Request with administrator context:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af94dfe_d23f12b2","line":253,"range":{"start_line":253,"start_character":0,"end_line":253,"end_character":3},"updated":"2016-03-18 13:52:36.000000000","message":"unnecessary spaces","commit_id":"00d6b82abbbd52ab723dd961466fb084426082ef"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"a1af74a3ea72178c236da066dd770b900d2a5848","unresolved":false,"context_lines":[{"line_number":647,"context_line":""},{"line_number":648,"context_line":".. code:: JSON"},{"line_number":649,"context_line":""},{"line_number":650,"context_line":"    Request: {"},{"line_number":651,"context_line":"       \"server\": {"},{"line_number":652,"context_line":"          \"name\":\"new-server-test\","},{"line_number":653,"context_line":"          \"imageRef\":\"52415800-8b69-11e0-9b19-734f6f006e54\","}],"source_content_type":"text/x-rst","patch_set":1,"id":"1af94dfe_322f56a2","line":650,"range":{"start_line":650,"start_character":4,"end_line":650,"end_character":13},"updated":"2016-03-18 13:52:36.000000000","message":"I think \"Request\" is never part of the JSON request body. The examples at [1] doesn\u0027t use that. It\u0027s also not valid JSON with this structure. Same below.\n\n[1] http://developer.openstack.org/api-ref-compute-v2.1.html#showServer","commit_id":"00d6b82abbbd52ab723dd961466fb084426082ef"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"641d8d4aea2d4a8e8710762e50b6dd292e906940","unresolved":false,"context_lines":[{"line_number":161,"context_line":"                    ..."},{"line_number":162,"context_line":"                },"},{"line_number":163,"context_line":"                {"},{"line_number":164,"context_line":"                    \"name\":\"t2\","},{"line_number":165,"context_line":"                    \"locked\": \"false\","},{"line_number":166,"context_line":"                    ..."},{"line_number":167,"context_line":"                }"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa0719c6_edd28dd1","line":164,"range":{"start_line":164,"start_character":20,"end_line":164,"end_character":30},"updated":"2016-03-22 16:27:05.000000000","message":"nit: JSON key value pairs are separated with a colon and a space. For example:\n\n    \"name\": \"t2\",\n\nSome more occurrences below.","commit_id":"b793ba83e85c839d6ea28d0e24b7dcf332085ee7"},{"author":{"_account_id":11303,"name":"Markus Zoeller (markus_z)","email":"mzoeller@linux.vnet.ibm.com","username":"mzoeller"},"change_message_id":"641d8d4aea2d4a8e8710762e50b6dd292e906940","unresolved":false,"context_lines":[{"line_number":734,"context_line":"   This process can be repeated until the whole cloud has been updated,"},{"line_number":735,"context_line":"   usually using a pool of empty hosts instead of just one."},{"line_number":736,"context_line":""},{"line_number":737,"context_line":"- **Resource Optimization**"},{"line_number":738,"context_line":""},{"line_number":739,"context_line":"   To reduce energy usage, some cloud operators will try and move"},{"line_number":740,"context_line":"   servers so they fit into the minimum number of hosts, allowing"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa0719c6_6ddddd0d","line":737,"range":{"start_line":737,"start_character":1,"end_line":737,"end_character":2},"updated":"2016-03-22 16:27:05.000000000","message":"Additional space needed, otherwise the text below will be a quote. This was already fixed in patch set 1 but sneaked back in.","commit_id":"b793ba83e85c839d6ea28d0e24b7dcf332085ee7"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"36f4a6e9f6ff5dc0423f3e9768f95e7cd2ed3787","unresolved":false,"context_lines":[{"line_number":144,"context_line":"Also, there are some special options such as ``changes-since`` can"},{"line_number":145,"context_line":"be used and interpreted by nova."},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"-  **General user \u0026 Administrator supported options**"},{"line_number":148,"context_line":"   General user supported options are listed above and administrator can"},{"line_number":149,"context_line":"   use almost all the options except the options parameters for sorting"},{"line_number":150,"context_line":"   and pagination."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"   **Precondition - There are 2 servers existing in cloud"},{"line_number":153,"context_line":"   with the following info:**"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1a122d0e_56cdb783","line":150,"range":{"start_line":147,"start_character":0,"end_line":150,"end_character":18},"updated":"2016-04-20 12:45:43.000000000","message":"Personally, I think this is still messy in the generated result. Could you make these top level bullet points into (sub)headings instead?","commit_id":"f24a2425590b412801851b5cb54799dd93473dd5"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"36f4a6e9f6ff5dc0423f3e9768f95e7cd2ed3787","unresolved":false,"context_lines":[{"line_number":149,"context_line":"   use almost all the options except the options parameters for sorting"},{"line_number":150,"context_line":"   and pagination."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"   **Precondition - There are 2 servers existing in cloud"},{"line_number":153,"context_line":"   with the following info:**"},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"   .. code:: JSON"},{"line_number":156,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1a122d0e_968bcf67","line":153,"range":{"start_line":152,"start_character":0,"end_line":153,"end_character":29},"updated":"2016-04-20 12:45:43.000000000","message":"You should spell out numbers from one to nine\n\nhttp://docs.openstack.org/contributor-guide/writing-style/num_and_units_of_measure.html\n\nThis (and other points) should be bullets. Also, this can fit on one line too","commit_id":"f24a2425590b412801851b5cb54799dd93473dd5"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"36f4a6e9f6ff5dc0423f3e9768f95e7cd2ed3787","unresolved":false,"context_lines":[{"line_number":172,"context_line":"   **Example: General user query server with administrator only options**"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"   **Request with non-administrator context:**"},{"line_number":175,"context_line":"   ``GET/servers/detail?locked\u003d1``"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"   .. code:: JSON"},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1a122d0e_7628b3e2","line":175,"range":{"start_line":175,"start_character":3,"end_line":175,"end_character":34},"updated":"2016-04-20 12:45:43.000000000","message":"Could you put these as separate code blocks similar to conventions in other docs [1]? Would make the link between request and response much clearer.\n\nhttps://developer.github.com/v3/issues/#list-issues-for-a-repository","commit_id":"f24a2425590b412801851b5cb54799dd93473dd5"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"36f4a6e9f6ff5dc0423f3e9768f95e7cd2ed3787","unresolved":false,"context_lines":[{"line_number":189,"context_line":"            ]"},{"line_number":190,"context_line":"        }"},{"line_number":191,"context_line":""},{"line_number":192,"context_line":"   **Example: Administrator query server with administrator only options**"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"   **Request with administrator context:**"},{"line_number":195,"context_line":"   ``GET /servers/detail?locked\u003d1``"},{"line_number":196,"context_line":""},{"line_number":197,"context_line":"   .. code:: JSON"},{"line_number":198,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1a122d0e_1fecebf1","line":195,"range":{"start_line":192,"start_character":0,"end_line":195,"end_character":35},"updated":"2016-04-20 12:45:43.000000000","message":"I don\u0027t think the second line should be bolded. It\u0027s not below.","commit_id":"f24a2425590b412801851b5cb54799dd93473dd5"},{"author":{"_account_id":6802,"name":"Joel Coffman","email":"jmc7tp@gmail.com","username":"joel-coffman"},"change_message_id":"ef0583cd81044024c67889846866aa9492f0deaa","unresolved":false,"context_lines":[{"line_number":702,"context_line":""},{"line_number":703,"context_line":"Example: Create server with access IP: JSON request"},{"line_number":704,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":705,"context_line":".. code:: JSON"},{"line_number":706,"context_line":""},{"line_number":707,"context_line":"    {"},{"line_number":708,"context_line":"        \"server\": {"}],"source_content_type":"text/x-rst","patch_set":9,"id":"dada55a8_c4f94182","line":705,"updated":"2016-07-19 22:59:12.000000000","message":"Should there be a blank line before this one to be consistent with other instances of \".. code:: JSON\" in this file (e.g., line 724-725)?","commit_id":"5f932fc955e52a09ed57d6d3796926d7cb8d7b88"}]}