)]}'
{"api-ref/source/v3-ext/index.rst":[{"author":{"_account_id":17860,"name":"Samuel de Medeiros Queiroz","email":"samueldmq@gmail.com","username":"samueldmq"},"change_message_id":"76fe06f69fa0cfafc03ed57a09e7ef534b3bc7a0","unresolved":false,"context_lines":[{"line_number":14,"context_line":"syntax so that it is easier to be read. These links do not resolve to"},{"line_number":15,"context_line":"anything valid, but exist to show a relationship. For example:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"For a user representation there might be a dictionary key ``relationships``"},{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_eb2136a1","line":17,"range":{"start_line":17,"start_character":26,"end_line":17,"end_character":42},"updated":"2017-08-09 20:32:20.000000000","message":"is there or not this ``relationships`` things in our APIs descriptions? Isn\u0027t this consistent so we can affirm \"there is\"","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"2a7ef30281dd302f4fb74d18521d8929046e51aa","unresolved":false,"context_lines":[{"line_number":14,"context_line":"syntax so that it is easier to be read. These links do not resolve to"},{"line_number":15,"context_line":"anything valid, but exist to show a relationship. For example:"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"For a user representation there might be a dictionary key ``relationships``"},{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_2b373eb3","line":17,"range":{"start_line":17,"start_character":26,"end_line":17,"end_character":42},"in_reply_to":"9f436f4f_eb2136a1","updated":"2017-08-09 20:37:24.000000000","message":"This paragraph is more to show what a relationship link is and why they exist as opposed to the links we have. I think we could add something that clarifies this.","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":17860,"name":"Samuel de Medeiros Queiroz","email":"samueldmq@gmail.com","username":"samueldmq"},"change_message_id":"76fe06f69fa0cfafc03ed57a09e7ef534b3bc7a0","unresolved":false,"context_lines":[{"line_number":17,"context_line":"For a user representation there might be a dictionary key ``relationships``"},{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":21,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_6b4ae655","line":20,"range":{"start_line":20,"start_character":2,"end_line":20,"end_character":3},"updated":"2017-08-09 20:32:20.000000000","message":"remove this slash, it is confusing I thought this was a URL :-)\n\nwhat about doing as python and use the quotation marks?\nuser[\u0027relationships\u0027][\u0027http://does-not-exist#user-groups\u0027]","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"2a7ef30281dd302f4fb74d18521d8929046e51aa","unresolved":false,"context_lines":[{"line_number":17,"context_line":"For a user representation there might be a dictionary key ``relationships``"},{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":21,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_0b659ab5","line":20,"range":{"start_line":20,"start_character":2,"end_line":20,"end_character":3},"in_reply_to":"9f436f4f_6b4ae655","updated":"2017-08-09 20:37:24.000000000","message":"yeah this can be cleaned up","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":17860,"name":"Samuel de Medeiros Queiroz","email":"samueldmq@gmail.com","username":"samueldmq"},"change_message_id":"76fe06f69fa0cfafc03ed57a09e7ef534b3bc7a0","unresolved":false,"context_lines":[{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":21,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":24,"context_line":"Identity API Extensions"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_eba4960a","line":21,"updated":"2017-08-09 20:32:20.000000000","message":"does this exist in keystone responses?","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"2a7ef30281dd302f4fb74d18521d8929046e51aa","unresolved":false,"context_lines":[{"line_number":18,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":19,"context_line":"representation. Then you could do something like"},{"line_number":20,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":21,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":24,"context_line":"Identity API Extensions"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9f436f4f_0b0a3ad1","line":21,"in_reply_to":"9f436f4f_eba4960a","updated":"2017-08-09 20:37:24.000000000","message":"See the first response, this should be an example describing what the relationship links are, rather than something from keystone itself.","commit_id":"22b84a7ba312f323cbe48281cb9546d78d2744ba"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"1cfa82fb2471aa0611acbd1a54350f56cd0c8d75","unresolved":false,"context_lines":[{"line_number":14,"context_line":"syntax so that it is easier to be read. These links do not resolve to"},{"line_number":15,"context_line":"anything valid, but exist to show a relationship."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"So an example of finding this URL \"relationship\" would be:"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"For a user representation there might be a dictionary key ``relationships``"},{"line_number":20,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9f436f4f_abd0cef8","line":17,"updated":"2017-08-09 20:47:46.000000000","message":"s/So//\n\nIsolating this line out on it\u0027s own seems a little odd. It feels like there should be some code after it since it ends with a colon. Maybe work this into the next paragraph?","commit_id":"1dc391f3ae2b046cc7f6d85d7443bb9b7315d10a"}],"api-ref/source/v3/authenticate-v3.inc":[{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"d3339a31b7ccaa96b0e47e72972f8cbaa6a46f7c","unresolved":false,"context_lines":[{"line_number":99,"context_line":""},{"line_number":100,"context_line":".. rest_method::  POST /v3/auth/tokens"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Relationship_: ``https://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``"},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Authenticates an identity and generates a token. Uses the password authentication method. Authorization is unscoped."},{"line_number":105,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":1,"id":"9f436f4f_6cbc4905","line":102,"updated":"2017-08-09 14:32:37.000000000","message":"I wonder if all of these are needed? Or if we can have a single blanket statement like we do in index.rst?","commit_id":"27b6eb243901445f8a63afd8640b27095cf4cc31"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"d4f1cd82e017947553e37269b833ccdccc3d93c3","unresolved":false,"context_lines":[{"line_number":99,"context_line":""},{"line_number":100,"context_line":".. rest_method::  POST /v3/auth/tokens"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Relationship_: ``https://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``"},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Authenticates an identity and generates a token. Uses the password authentication method. Authorization is unscoped."},{"line_number":105,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":1,"id":"9f436f4f_d2274c12","line":102,"in_reply_to":"9f436f4f_6cbc4905","updated":"2017-08-09 15:42:26.000000000","message":"These should link to the blanket statement in index.rst. This may be unnecessary though.","commit_id":"27b6eb243901445f8a63afd8640b27095cf4cc31"}],"api-ref/source/v3/index.rst":[{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"9211ea7856b094c69392cd54007e3c753f95c38d","unresolved":false,"context_lines":[{"line_number":154,"context_line":"- Partial updates are performed using the HTTP ``PATCH`` method"},{"line_number":155,"context_line":"- Token ID values no longer appear in URLs"},{"line_number":156,"context_line":""},{"line_number":157,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":158,"context_line":"Relationships"},{"line_number":159,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"The entries within the operations below contain a relationship link, which"},{"line_number":162,"context_line":"appears as a valid URI, however these are actually"},{"line_number":163,"context_line":"URN (Uniform Resource Name), which are similar to GUID except it uses a URI"},{"line_number":164,"context_line":"syntax so that it is easier to be read. These links do not resolve to"},{"line_number":165,"context_line":"anything valid, but exist to show a relationship. For example:"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"For a user representation there might be a dictionary key `relationships`"},{"line_number":168,"context_line":"and the value would map URN to URL. So `GET /user/1234/` gives you a user"},{"line_number":169,"context_line":"representation. Then you could do something like"},{"line_number":170,"context_line":"`/user[relationships][http://does-not-exist#user-groups]` to find a URL"},{"line_number":171,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"This page lists the Identity API operations in the following order:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9f436f4f_b935e8f9","line":171,"range":{"start_line":157,"start_character":0,"end_line":171,"end_character":45},"updated":"2017-08-08 21:30:17.000000000","message":"This section should probably go somewhere else, it looks weird here right before the list of operations. Or we could add a header below as well.","commit_id":"27b6eb243901445f8a63afd8640b27095cf4cc31"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"d8495cdb9ba6762f97128e8a9643315248c58bc3","unresolved":false,"context_lines":[{"line_number":168,"context_line":"and the value would map URN to URL. So `GET /user/1234/` gives you a user"},{"line_number":169,"context_line":"representation. Then you could do something like"},{"line_number":170,"context_line":"`/user[relationships][http://does-not-exist#user-groups]` to find a URL"},{"line_number":171,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"This page lists the Identity API operations in the following order:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9f436f4f_740f822e","line":171,"in_reply_to":"9f436f4f_b935e8f9","updated":"2017-08-09 02:00:28.000000000","message":"Agreed - we could make a new heading so that the content under the \"Relationships\" section doesn\u0027t look directly associated to the section.","commit_id":"27b6eb243901445f8a63afd8640b27095cf4cc31"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"a8da2944511e74763b74fe189c4e3f277e35a80a","unresolved":false,"context_lines":[{"line_number":168,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":169,"context_line":"representation. Then you could do something like"},{"line_number":170,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":171,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":174,"context_line":"Identity API Operations"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9f436f4f_09000a67","line":171,"updated":"2017-08-09 16:50:26.000000000","message":"I think this statement will suffice for now. If we keep getting questions on Relationships then we can look at ways to advertise this better.","commit_id":"84445de244c9bc29d41e2d6db1f1d3aed1003496"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"a5fb73a894401bf1d18efdb10355fc5ed8b7e4c2","unresolved":false,"context_lines":[{"line_number":168,"context_line":"and the value would map URN to URL. So ``GET /user/1234/`` gives you a user"},{"line_number":169,"context_line":"representation. Then you could do something like"},{"line_number":170,"context_line":"``/user[relationships][http://does-not-exist#user-groups]`` to find a URL"},{"line_number":171,"context_line":"that can be used to retrieve a user\u0027s groups."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":174,"context_line":"Identity API Operations"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9f436f4f_5c1eceba","line":171,"in_reply_to":"9f436f4f_09000a67","updated":"2017-08-09 17:33:41.000000000","message":"Done","commit_id":"84445de244c9bc29d41e2d6db1f1d3aed1003496"}]}