)]}'
{"api-ref/source/v3/parameters.yaml":[{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"879e2bebd6d9e6e5b608ffe7289bf08da3a51a31","unresolved":false,"context_lines":[{"line_number":849,"context_line":"  in: body"},{"line_number":850,"context_line":"  required: false"},{"line_number":851,"context_line":"  type: string"},{"line_number":852,"context_line":"extra_request_body:"},{"line_number":853,"context_line":"  description: |"},{"line_number":854,"context_line":"    The extra info for the user."},{"line_number":855,"context_line":"    In fact ``extra`` is not the real key name in request body."}],"source_content_type":"text/x-yaml","patch_set":2,"id":"9f91af0f_bee9d5b7","line":852,"range":{"start_line":852,"start_character":0,"end_line":852,"end_character":18},"updated":"2018-01-07 00:03:32.000000000","message":"Not sure if this directly conflicts with how we decided to name these parameters, but it seems like we could either use this with a generic description linked below and reuse this parameter for the other resources within keystone that allow extra attributes, or rename this to something like \"users_extra_request_body\" and make the description something specific regarding users.","commit_id":"17a36297cfcec32e61f551321ebf147df1756e68"},{"author":{"_account_id":27372,"name":"wangqiang-bj","email":"wangqiangbj@inspur.com","username":"wangqiangbj"},"change_message_id":"8f6df3d4756872bebab7217198f1654acf1ed00e","unresolved":false,"context_lines":[{"line_number":849,"context_line":"  in: body"},{"line_number":850,"context_line":"  required: false"},{"line_number":851,"context_line":"  type: string"},{"line_number":852,"context_line":"extra_request_body:"},{"line_number":853,"context_line":"  description: |"},{"line_number":854,"context_line":"    The extra info for the user."},{"line_number":855,"context_line":"    In fact ``extra`` is not the real key name in request body."}],"source_content_type":"text/x-yaml","patch_set":2,"id":"9f91af0f_44b31c4e","line":852,"range":{"start_line":852,"start_character":0,"end_line":852,"end_character":18},"in_reply_to":"9f91af0f_bee9d5b7","updated":"2018-01-07 09:19:24.000000000","message":"Hugo, Thanks for your good advice. To reuse this parameter I decide to use \u0027extra_request_body\u0027 within a generic description. I\u0027am not a native, and my description is not so accurate.\nyour description linkd below looks good to me. thanks again.","commit_id":"17a36297cfcec32e61f551321ebf147df1756e68"},{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"879e2bebd6d9e6e5b608ffe7289bf08da3a51a31","unresolved":false,"context_lines":[{"line_number":851,"context_line":"  type: string"},{"line_number":852,"context_line":"extra_request_body:"},{"line_number":853,"context_line":"  description: |"},{"line_number":854,"context_line":"    The extra info for the user."},{"line_number":855,"context_line":"    In fact ``extra`` is not the real key name in request body."},{"line_number":856,"context_line":"    It can be any word different from that above."},{"line_number":857,"context_line":"    For example, ``email`` represents user\u0027s email info"},{"line_number":858,"context_line":"    and ``description`` shows descriptive info of the user."},{"line_number":859,"context_line":"  in: body"},{"line_number":860,"context_line":"  required: false"},{"line_number":861,"context_line":"  type: string"}],"source_content_type":"text/x-yaml","patch_set":2,"id":"9f91af0f_1ed8011c","line":858,"range":{"start_line":854,"start_character":4,"end_line":858,"end_character":59},"updated":"2018-01-07 00:03:32.000000000","message":"Below is a more generic description to describe extra, which could be reused for other resources in keystone, like projects.\n\n\"The extra attributes of a resource.\nThe actual name ``extra`` is not the key name in the request body, but rather a collection of any attributes that a resource may contain that are not part of the resource\u0027s default attributes. Generally these are custom fields that are added to a resource in keystone by operators for their own specific uses, such as ``email`` and ``description`` for users.\"","commit_id":"17a36297cfcec32e61f551321ebf147df1756e68"}]}