)]}'
{"api/v3/identity-api-v3.rst":[{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"70ded405835b45d7bbf7d6c832e2ce66479ee686","unresolved":false,"context_lines":[{"line_number":19,"context_line":"  represents whether a project is acting as a domain."},{"line_number":20,"context_line":"- Enable or disable a subtree in the project hierarchy."},{"line_number":21,"context_line":"- Delete a subtree in the project hierarchy."},{"line_number":22,"context_line":"- Enhance list role assignment to optionally provide names of entities."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"What\u0027s New in Version 3.5"},{"line_number":25,"context_line":"-------------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a26ad4f_17b64b3d","line":22,"updated":"2015-11-01 10:59:03.000000000","message":"shouldn\u0027t this be under a new section?\n\n  What\u0027s New in Version 3.7\n\n?","commit_id":"d33f70f719c2302c3ed725bcb084abc73ad57931"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"a68aea400060e307432dec883c2c229a0c19c617","unresolved":false,"context_lines":[{"line_number":19,"context_line":"  represents whether a project is acting as a domain."},{"line_number":20,"context_line":"- Enable or disable a subtree in the project hierarchy."},{"line_number":21,"context_line":"- Delete a subtree in the project hierarchy."},{"line_number":22,"context_line":"- Enhance list role assignment to optionally provide names of entities."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"What\u0027s New in Version 3.5"},{"line_number":25,"context_line":"-------------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a26ad4f_c0746f37","line":22,"in_reply_to":"1a26ad4f_17b64b3d","updated":"2015-11-01 17:12:21.000000000","message":"no Liberty \u003d 3.5, all the other things above were originally in 3.5, but because they didn\u0027t land, I has an earlier patch in to move them to 3.6","commit_id":"d33f70f719c2302c3ed725bcb084abc73ad57931"},{"author":{"_account_id":6460,"name":"Brad Topol","email":"btopol@us.ibm.com","username":"btopol"},"change_message_id":"cff1e5cf0dbc09a1cae6d6d065c3135d36865c06","unresolved":false,"context_lines":[{"line_number":5310,"context_line":""},{"line_number":5311,"context_line":"Optional query parameters:"},{"line_number":5312,"context_line":""},{"line_number":5313,"context_line":"- ``group.domain.name`` (string) *New in version 3.6* This can only be"},{"line_number":5314,"context_line":"    specified if ``group.name`` is also specified, and is used to uniquely"},{"line_number":5315,"context_line":"    identify the group required."},{"line_number":5316,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a26ad4f_ffb1e101","line":5313,"updated":"2015-11-02 22:38:51.000000000","message":"So I\u0027m a little confused. The way the spec was written I would have only expected to see include_names added.  But instead you added a whole bunch of extra optional query parameters that makes it seem like you are making it possible to query for a specific entity name.  If that is the case then in the spec you should make it clear that in addition to adding include_names you are also supporting the ability to query for a specific entity name.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"58822d02be9bff5acca7207c9e2f5a576c3ae345","unresolved":false,"context_lines":[{"line_number":5310,"context_line":""},{"line_number":5311,"context_line":"Optional query parameters:"},{"line_number":5312,"context_line":""},{"line_number":5313,"context_line":"- ``group.domain.name`` (string) *New in version 3.6* This can only be"},{"line_number":5314,"context_line":"    specified if ``group.name`` is also specified, and is used to uniquely"},{"line_number":5315,"context_line":"    identify the group required."},{"line_number":5316,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_ca092b2e","line":5313,"in_reply_to":"1a26ad4f_675d3f14","updated":"2015-11-04 15:43:55.000000000","message":"so in OSC it\u0027s messy, we leverage /roles and add queries there to find roles that a user has on a project (since we can\u0027t figure out what roles has has on ANY project).\n\nI think for now, we can remove these queries; 1) they already exist in a similar fashion somewhere else, and 2) as long as we are given the names we can sift through the output (for now).\n\nWe might want this at a later date, but i\u0027m OK with taking this one step at a time.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"cae25743c7531c5314732f5b94ff73b65e7cfc23","unresolved":false,"context_lines":[{"line_number":5310,"context_line":""},{"line_number":5311,"context_line":"Optional query parameters:"},{"line_number":5312,"context_line":""},{"line_number":5313,"context_line":"- ``group.domain.name`` (string) *New in version 3.6* This can only be"},{"line_number":5314,"context_line":"    specified if ``group.name`` is also specified, and is used to uniquely"},{"line_number":5315,"context_line":"    identify the group required."},{"line_number":5316,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a26ad4f_675d3f14","line":5313,"in_reply_to":"1a26ad4f_ffb1e101","updated":"2015-11-03 08:53:04.000000000","message":"I think that\u0027s a very fair comment!  I originally didn\u0027t have this in here, but then added it as I looked at the usability.  However, I think the real requirement is for osc to support specifying the names in its assignment query command.....which of course does not necessarily mean the API must support it (since osc could do a lookup by name, get the id and then use that to issue the API assignment list command). Let\u0027s get some other people\u0027s views on whether we should be supporting the query-by-name in this API....I\u0027m kind of tempted to take it out again!","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5310,"context_line":""},{"line_number":5311,"context_line":"Optional query parameters:"},{"line_number":5312,"context_line":""},{"line_number":5313,"context_line":"- ``group.domain.name`` (string) *New in version 3.6* This can only be"},{"line_number":5314,"context_line":"    specified if ``group.name`` is also specified, and is used to uniquely"},{"line_number":5315,"context_line":"    identify the group required."},{"line_number":5316,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_540959dc","line":5313,"in_reply_to":"fa80f949_ca092b2e","updated":"2015-11-04 19:29:41.000000000","message":"I agree. If we return the complete ref for the role assignment elements, that should be enough for us the render a more meaningful display without any more additional lookups. We don\u0027t need the name query params right now.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5497,"context_line":"parameter also contains, for entities that are included by virtue of group"},{"line_number":5498,"context_line":"membership, a url that can be used to access the membership of the group."},{"line_number":5499,"context_line":""},{"line_number":5500,"context_line":"If the query parameter ``include_names`` is specified, rather than simply"},{"line_number":5501,"context_line":"returning the entity IDs in the role assignments, the collection will"},{"line_number":5502,"context_line":"additionally include the names of the entities. For example:"},{"line_number":5503,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_142af12c","line":5500,"updated":"2015-11-04 19:29:41.000000000","message":"\"include_names\" doesn\u0027t sound right. How about \"include_refs\", since we should be returning the refs anyway?","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5518,"context_line":"                },"},{"line_number":5519,"context_line":"                \"role\": {"},{"line_number":5520,"context_line":"                    \"id\": \"--role-id--\","},{"line_number":5521,"context_line":"                    \"name\": \"--role-name--\""},{"line_number":5522,"context_line":"                },"},{"line_number":5523,"context_line":"                \"scope\": {"},{"line_number":5524,"context_line":"                    \"domain\": {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_d41c6915","line":5521,"updated":"2015-11-04 19:29:41.000000000","message":"this should be a complete role ref, including \"links\".","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5523,"context_line":"                \"scope\": {"},{"line_number":5524,"context_line":"                    \"domain\": {"},{"line_number":5525,"context_line":"                        \"id\": \"--domain-id--\","},{"line_number":5526,"context_line":"                        \"name\": \"--domain-name--\""},{"line_number":5527,"context_line":"                    }"},{"line_number":5528,"context_line":"                },"},{"line_number":5529,"context_line":"                \"user\": {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_34d4d51e","line":5526,"updated":"2015-11-04 19:29:41.000000000","message":"domain ref","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5531,"context_line":"                        \"name\": \"--domain-name--\""},{"line_number":5532,"context_line":"                    },"},{"line_number":5533,"context_line":"                    \"id\": \"--user-id--\","},{"line_number":5534,"context_line":"                    \"name\": \"--user-name--\""},{"line_number":5535,"context_line":"                }"},{"line_number":5536,"context_line":"            },"},{"line_number":5537,"context_line":"            {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_f4dded42","line":5534,"updated":"2015-11-04 19:29:41.000000000","message":"user ref","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5541,"context_line":"                },"},{"line_number":5542,"context_line":"                \"role\": {"},{"line_number":5543,"context_line":"                    \"id\": \"--role-id--\","},{"line_number":5544,"context_line":"                    \"name\": \"--role-name--\""},{"line_number":5545,"context_line":"                },"},{"line_number":5546,"context_line":"                \"scope\": {"},{"line_number":5547,"context_line":"                    \"project\": {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_d4e30904","line":5544,"updated":"2015-11-04 19:29:41.000000000","message":"same as above","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5549,"context_line":"                            \"name\": \"--domain-name--\""},{"line_number":5550,"context_line":"                        }"},{"line_number":5551,"context_line":"                        \"id\": \"--project-id--\","},{"line_number":5552,"context_line":"                        \"name\": \"--project-name--\""},{"line_number":5553,"context_line":"                    }"},{"line_number":5554,"context_line":"                },"},{"line_number":5555,"context_line":"                \"user\": {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_34bb75e7","line":5552,"updated":"2015-11-04 19:29:41.000000000","message":"same as above","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":5558,"context_line":"                    },"},{"line_number":5559,"context_line":"                    \"id\": \"--user-id--\","},{"line_number":5560,"context_line":"                    \"name\": \"--user-name--\""},{"line_number":5561,"context_line":"                }"},{"line_number":5562,"context_line":"            }"},{"line_number":5563,"context_line":"        ],"},{"line_number":5564,"context_line":"        \"links\": {"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_f4b40df3","line":5561,"updated":"2015-11-04 19:29:41.000000000","message":"same as above","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"cc1f844a595a48ac8009b59927a7a01918ed7588","unresolved":false,"context_lines":[{"line_number":5453,"context_line":"    {"},{"line_number":5454,"context_line":"        \"role_assignments\": ["},{"line_number":5455,"context_line":"            {"},{"line_number":5456,"context_line":"                \"links\": {"},{"line_number":5457,"context_line":"                    \"assignment\": \"http://identity:35357/v3/domains/--domain-id--/users/--user-id--/roles/--role-id--\""},{"line_number":5458,"context_line":"                },"},{"line_number":5459,"context_line":"                \"role\": {"}],"source_content_type":"text/x-rst","patch_set":4,"id":"da85f559_8b1a6e16","line":5456,"updated":"2015-11-08 20:31:59.000000000","message":"this needs a `membership` block too","commit_id":"10841555cb36e8034fdcb25dd207f8b4ec57a76c"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"4d3af0ffb82af5b1168a6cb2fc8919e8c585f909","unresolved":false,"context_lines":[{"line_number":5453,"context_line":"    {"},{"line_number":5454,"context_line":"        \"role_assignments\": ["},{"line_number":5455,"context_line":"            {"},{"line_number":5456,"context_line":"                \"links\": {"},{"line_number":5457,"context_line":"                    \"assignment\": \"http://identity:35357/v3/domains/--domain-id--/users/--user-id--/roles/--role-id--\""},{"line_number":5458,"context_line":"                },"},{"line_number":5459,"context_line":"                \"role\": {"}],"source_content_type":"text/x-rst","patch_set":4,"id":"da85f559_61ee4b24","line":5456,"in_reply_to":"da85f559_8b1a6e16","updated":"2015-11-08 23:38:24.000000000","message":"Actually, no, this assignment is a direct user assignment. You only get a membership url when the assignment results from a group membership","commit_id":"10841555cb36e8034fdcb25dd207f8b4ec57a76c"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"cc1f844a595a48ac8009b59927a7a01918ed7588","unresolved":false,"context_lines":[{"line_number":5502,"context_line":"            }"},{"line_number":5503,"context_line":"        ],"},{"line_number":5504,"context_line":"        \"links\": {"},{"line_number":5505,"context_line":"            \"self\": \"http://identity:35357/v3/role_assignments?effective\","},{"line_number":5506,"context_line":"            \"previous\": null,"},{"line_number":5507,"context_line":"            \"next\": null"},{"line_number":5508,"context_line":"        }"}],"source_content_type":"text/x-rst","patch_set":4,"id":"da85f559_2b2b4232","line":5505,"updated":"2015-11-08 20:31:59.000000000","message":"this needs to be updated","commit_id":"10841555cb36e8034fdcb25dd207f8b4ec57a76c"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"4d3af0ffb82af5b1168a6cb2fc8919e8c585f909","unresolved":false,"context_lines":[{"line_number":5502,"context_line":"            }"},{"line_number":5503,"context_line":"        ],"},{"line_number":5504,"context_line":"        \"links\": {"},{"line_number":5505,"context_line":"            \"self\": \"http://identity:35357/v3/role_assignments?effective\","},{"line_number":5506,"context_line":"            \"previous\": null,"},{"line_number":5507,"context_line":"            \"next\": null"},{"line_number":5508,"context_line":"        }"}],"source_content_type":"text/x-rst","patch_set":4,"id":"da85f559_81b9ef30","line":5505,"in_reply_to":"da85f559_2b2b4232","updated":"2015-11-08 23:38:24.000000000","message":"Done","commit_id":"10841555cb36e8034fdcb25dd207f8b4ec57a76c"},{"author":{"_account_id":1941,"name":"Lin Hua Cheng","email":"os.lcheng@gmail.com","username":"lin-hua-cheng"},"change_message_id":"7db345219e7c2d68388f063b103c4f4cf82afe26","unresolved":false,"context_lines":[{"line_number":5519,"context_line":"                    }"},{"line_number":5520,"context_line":"                },"},{"line_number":5521,"context_line":"                \"user\": {"},{"line_number":5522,"context_line":"                    \"domain\": {"},{"line_number":5523,"context_line":"                        \"name\": \"--domain-name--\""},{"line_number":5524,"context_line":"                    },"},{"line_number":5525,"context_line":"                    \"id\": \"--user-id--\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"da85f559_f86f25fa","line":5522,"updated":"2015-11-14 05:47:18.000000000","message":"why not include \"id\"?","commit_id":"742ed760596ce3401a19fed2cb97a754b1f2113f"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"bca5efd41ae44229579d66037951ce24f742bb92","unresolved":false,"context_lines":[{"line_number":5519,"context_line":"                    }"},{"line_number":5520,"context_line":"                },"},{"line_number":5521,"context_line":"                \"user\": {"},{"line_number":5522,"context_line":"                    \"domain\": {"},{"line_number":5523,"context_line":"                        \"name\": \"--domain-name--\""},{"line_number":5524,"context_line":"                    },"},{"line_number":5525,"context_line":"                    \"id\": \"--user-id--\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"da85f559_e334564b","line":5522,"in_reply_to":"da85f559_f86f25fa","updated":"2015-11-14 07:30:39.000000000","message":"I think that\u0027s actually a valid point. We do return both name and ID in, for example, the token response - so we should be consistent....and an ID is probably also useful if the caller does want to get more information about the domain in question.","commit_id":"742ed760596ce3401a19fed2cb97a754b1f2113f"},{"author":{"_account_id":1941,"name":"Lin Hua Cheng","email":"os.lcheng@gmail.com","username":"lin-hua-cheng"},"change_message_id":"7db345219e7c2d68388f063b103c4f4cf82afe26","unresolved":false,"context_lines":[{"line_number":5537,"context_line":"                },"},{"line_number":5538,"context_line":"                \"scope\": {"},{"line_number":5539,"context_line":"                    \"project\": {"},{"line_number":5540,"context_line":"                        \"domain\": {"},{"line_number":5541,"context_line":"                            \"name\": \"--domain-name--\""},{"line_number":5542,"context_line":"                        }"},{"line_number":5543,"context_line":"                        \"id\": \"--project-id--\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"da85f559_5881918e","line":5540,"updated":"2015-11-14 05:47:18.000000000","message":"ditto","commit_id":"742ed760596ce3401a19fed2cb97a754b1f2113f"},{"author":{"_account_id":1941,"name":"Lin Hua Cheng","email":"os.lcheng@gmail.com","username":"lin-hua-cheng"},"change_message_id":"7db345219e7c2d68388f063b103c4f4cf82afe26","unresolved":false,"context_lines":[{"line_number":5545,"context_line":"                    }"},{"line_number":5546,"context_line":"                },"},{"line_number":5547,"context_line":"                \"user\": {"},{"line_number":5548,"context_line":"                    \"domain\": {"},{"line_number":5549,"context_line":"                        \"name\": \"--domain-name--\""},{"line_number":5550,"context_line":"                    },"},{"line_number":5551,"context_line":"                    \"id\": \"--user-id--\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"da85f559_9877f9d3","line":5548,"updated":"2015-11-14 05:47:18.000000000","message":"ditto","commit_id":"742ed760596ce3401a19fed2cb97a754b1f2113f"}],"specs/liberty/list-assignment-names.rst":[{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":19,"context_line":"The current list assignment API returns just the IDs of the entities. In"},{"line_number":20,"context_line":"general, for this to be useful, a client would typically have to convert these"},{"line_number":21,"context_line":"IDs into the names of the entities. It would be much more efficient if this"},{"line_number":22,"context_line":"could be done in the server as part of the API."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Proposed Change"},{"line_number":25,"context_line":"\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":"fa80f949_94726148","line":22,"updated":"2015-11-04 19:29:41.000000000","message":"This also saved us from multiple roundtrips to the backend to retrieve all the refs in order to render a more intuitive output.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Proposed Change"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Support an additional query parameter `include_names` to the list"},{"line_number":28,"context_line":"assignment API. If specified as `true`, then each of the entities returned"},{"line_number":29,"context_line":"will include the name. For entities who\u0027s name is only unique within a domain,"},{"line_number":30,"context_line":"the domain name is also returned. The ability to list assignments by entity"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_149d1159","line":27,"updated":"2015-11-04 19:29:41.000000000","message":"s/include_names/include_refs/?\n\nI am fine with \u0027include_entities\u0027 as well, since we should be returning the entire ref instead of just name and ID.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":5707,"name":"Henry Nash","email":"henryn@linux.vnet.ibm.com","username":"henry-nash"},"change_message_id":"42077a67ad4af35525228eaaabcc210ee7bf529d","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Proposed Change"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Support an additional query parameter `include_names` to the list"},{"line_number":28,"context_line":"assignment API. If specified as `true`, then each of the entities returned"},{"line_number":29,"context_line":"will include the name. For entities who\u0027s name is only unique within a domain,"},{"line_number":30,"context_line":"the domain name is also returned. The ability to list assignments by entity"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_1954211f","line":27,"in_reply_to":"fa80f949_149d1159","updated":"2015-11-06 10:32:24.000000000","message":"Gyee - do you have a concrete example of where the attributes other than name in the ref would be commonly useful?","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"90051f47081acda2fca0879cf71f87c9a81ee3ad","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Proposed Change"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Support an additional query parameter `include_names` to the list"},{"line_number":28,"context_line":"assignment API. If specified as `true`, then each of the entities returned"},{"line_number":29,"context_line":"will include the name. For entities who\u0027s name is only unique within a domain,"},{"line_number":30,"context_line":"the domain name is also returned. The ability to list assignments by entity"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_5349125f","line":27,"in_reply_to":"fa80f949_1954211f","updated":"2015-11-06 17:09:58.000000000","message":"per my understanding we are returning complete ref to facilitate HATEOAS clients even though we only advertise \u0027self\u0027 links right now.\n\nhttps://en.wikipedia.org/wiki/HATEOAS\n\nI know OpenStack python clients doesn\u0027t use it. But other non python clients may take advantage of it.\n\nIn any case, we need to be consistent with our data response.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":33,"context_line":"While we could return all the attributes of each entity, given the potential"},{"line_number":34,"context_line":"large number of elements in a collection, we only include the name. The `id` is"},{"line_number":35,"context_line":"also still returned so that if the caller needs the full entity they can obtain"},{"line_number":36,"context_line":"it."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_f4fe4d6a","line":36,"updated":"2015-11-04 19:29:41.000000000","message":"We should be returning the refs. The whole point of this is to save us from multiple roundtrips to the backend to lookup the entire ref.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"},{"author":{"_account_id":1916,"name":"Guang Yee","email":"gyee@suse.com","username":"guang-yee"},"change_message_id":"c8160a72939741ee5a804b534a2e58017e4fc538","unresolved":false,"context_lines":[{"line_number":69,"context_line":"------------------"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"There is obviously a potential performance impact for large collections."},{"line_number":72,"context_line":"This will be minimized where possible with efficient SQL coding."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"Other Deployer Impact"},{"line_number":75,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"fa80f949_541639a8","line":72,"updated":"2015-11-04 19:29:41.000000000","message":"I would even argue that this may improve performance as it will save UI and CLI from multiple roundtrips to the backend to lookup the refs.","commit_id":"5a4497729b77a3587956455b31d6556e54ea2f99"}]}