)]}'
{"guidelines/links.rst":[{"author":{"_account_id":8246,"name":"Qiming Teng","email":"tengqm@outlook.com","username":"tengqm"},"change_message_id":"5e9dd6895825fd19c5db15a5691e3ef508943e0b","unresolved":false,"context_lines":[{"line_number":26,"context_line":"          \"links\": ["},{"line_number":27,"context_line":"            {"},{"line_number":28,"context_line":"              \"rel\": \"help\","},{"line_number":29,"context_line":"              \"href\": \"http://developer.openstack.org/api-ref/compute/#create-server\""},{"line_number":30,"context_line":"            }"},{"line_number":31,"context_line":"          ]"},{"line_number":32,"context_line":"        }"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad45d7e_678c5cda","line":29,"updated":"2016-08-12 03:40:33.000000000","message":"This example is a little bit misleading because contains a full URL instead of a relative one. The example is NOT wrong because it is pointing to a URL where you can get help docs. However, developers may start adding \u0027href\u0027 pointing to a full URL instead of a relative one, by following this example.\n\nThe examples on the JSON schema site is much better because it is implicitly advocating the usage of relative URIs. That, IMHO, is what we should encourage in OpenStack.","commit_id":"4e32b783ae37233fd9b1f26b48df774dbfd83380"},{"author":{"_account_id":6223,"name":"Cody A.W. Somerville","email":"cody.somerville@gmail.com","username":"cody-somerville"},"change_message_id":"3060ff6964a36f44f85f1f8c84d3e64eaeff9481","unresolved":false,"context_lines":[{"line_number":26,"context_line":"          \"links\": ["},{"line_number":27,"context_line":"            {"},{"line_number":28,"context_line":"              \"rel\": \"help\","},{"line_number":29,"context_line":"              \"href\": \"http://developer.openstack.org/api-ref/compute/#create-server\""},{"line_number":30,"context_line":"            }"},{"line_number":31,"context_line":"          ]"},{"line_number":32,"context_line":"        }"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3ac371cc_5640c707","line":29,"in_reply_to":"9ad45d7e_678c5cda","updated":"2016-08-19 03:43:08.000000000","message":"The JSON Schema definition actually *explicitly* states that href MAY be relative instead of SHOULD. As the document uses the words \"may\" and \"should\" as described in RFC 2119, href being relative is truly optional. \n\nIf you are properly handling and interpreting the URI per RFC 3986 as the Json Schema Definition states you should, you shouldn\u0027t run into any problems either way.","commit_id":"4e32b783ae37233fd9b1f26b48df774dbfd83380"}]}