)]}'
{"api-ref/source/parameters.yaml":[{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"13b32b71661106cfb3ba6b420517c1d22bf1ef54","unresolved":false,"context_lines":[{"line_number":3492,"context_line":"  type: string"},{"line_number":3493,"context_line":"policies:"},{"line_number":3494,"context_line":"  description: |"},{"line_number":3495,"context_line":"    A list of exactly one policy name to associate with the server group. The"},{"line_number":3496,"context_line":"    current valid policy names are:"},{"line_number":3497,"context_line":""},{"line_number":3498,"context_line":"    - ``anti-affinity`` - servers in this group must be scheduled to"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"da4df55a_a8567427","line":3495,"range":{"start_line":3495,"start_character":14,"end_line":3495,"end_character":25},"updated":"2016-12-28 15:17:20.000000000","message":"To make this look less odd, I would phrase it in a way that it is a list of policies and also add that the current supported policies are mutually exclusive. It can also be added that it means picking exactly one if we would want to be super bullet proof...","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"994974db0f7623c1ad7685cfc64a84b2d2667587","unresolved":false,"context_lines":[{"line_number":3492,"context_line":"  type: string"},{"line_number":3493,"context_line":"policies:"},{"line_number":3494,"context_line":"  description: |"},{"line_number":3495,"context_line":"    A list of exactly one policy name to associate with the server group. The"},{"line_number":3496,"context_line":"    current valid policy names are:"},{"line_number":3497,"context_line":""},{"line_number":3498,"context_line":"    - ``anti-affinity`` - servers in this group must be scheduled to"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"ba5201f7_776fb092","line":3495,"range":{"start_line":3495,"start_character":14,"end_line":3495,"end_character":25},"in_reply_to":"da4df55a_0332035f","updated":"2016-12-30 08:28:02.000000000","message":"I think this is OK as Matt proposed. If later somebody adds a policy that can be mixed with the existing ones then we can change the doc to tell which policies are exclusive and which are not.","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"1d42e4f39ef95b0928d6c2776386dc437b961c15","unresolved":false,"context_lines":[{"line_number":3492,"context_line":"  type: string"},{"line_number":3493,"context_line":"policies:"},{"line_number":3494,"context_line":"  description: |"},{"line_number":3495,"context_line":"    A list of exactly one policy name to associate with the server group. The"},{"line_number":3496,"context_line":"    current valid policy names are:"},{"line_number":3497,"context_line":""},{"line_number":3498,"context_line":"    - ``anti-affinity`` - servers in this group must be scheduled to"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"da4df55a_0332035f","line":3495,"range":{"start_line":3495,"start_character":14,"end_line":3495,"end_character":25},"in_reply_to":"da4df55a_63a58fa0","updated":"2016-12-28 15:53:53.000000000","message":"I meant the \u0027list of exactly one\u0027 part here, but fair enough, most probably that\u0027s the clearest you can be. :)","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"488d64a6fe49b69384e2b980077ac348331ba807","unresolved":false,"context_lines":[{"line_number":3492,"context_line":"  type: string"},{"line_number":3493,"context_line":"policies:"},{"line_number":3494,"context_line":"  description: |"},{"line_number":3495,"context_line":"    A list of exactly one policy name to associate with the server group. The"},{"line_number":3496,"context_line":"    current valid policy names are:"},{"line_number":3497,"context_line":""},{"line_number":3498,"context_line":"    - ``anti-affinity`` - servers in this group must be scheduled to"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"da4df55a_63a58fa0","line":3495,"range":{"start_line":3495,"start_character":14,"end_line":3495,"end_character":25},"in_reply_to":"da4df55a_a8567427","updated":"2016-12-28 15:48:41.000000000","message":"Well, mutually exclusive or not, you can only have exactly one, which is why I phrased it this way.","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"0e47398a68f9b163a3dbda11155d351deec17da7","unresolved":false,"context_lines":[{"line_number":3496,"context_line":"    current valid policy names are:"},{"line_number":3497,"context_line":""},{"line_number":3498,"context_line":"    - ``anti-affinity`` - servers in this group must be scheduled to"},{"line_number":3499,"context_line":"      different hosts."},{"line_number":3500,"context_line":"    - ``affinity`` - servers in this group must be scheduled to the same host."},{"line_number":3501,"context_line":"    - ``soft-anti-affinity`` - servers in this group should be scheduled to"},{"line_number":3502,"context_line":"      different hosts if possible, but if not possible then they should still"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"ba5201f7_4069cc24","line":3499,"updated":"2017-01-03 19:15:07.000000000","message":"Looks fine in the generated draft. Might be nice to format the string description as a complete sentence. See parameter disk_config for an example.\n- ``anti-affinity``. Servers in this group ...\n\nAlso, looking at the draft the request example contains a server_group, but this parameter is not listed in the parameter table. In the response, the parameter table lists a server_groups array, but the response example shows a single server_group object?","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"994974db0f7623c1ad7685cfc64a84b2d2667587","unresolved":false,"context_lines":[{"line_number":3499,"context_line":"      different hosts."},{"line_number":3500,"context_line":"    - ``affinity`` - servers in this group must be scheduled to the same host."},{"line_number":3501,"context_line":"    - ``soft-anti-affinity`` - servers in this group should be scheduled to"},{"line_number":3502,"context_line":"      different hosts if possible, but if not possible then they should still"},{"line_number":3503,"context_line":"      be scheduled instead of resulting in a build failure. This policy was"},{"line_number":3504,"context_line":"      added in microversion 2.15."},{"line_number":3505,"context_line":"    - ``soft-affinity`` - servers in this group should be scheduled to the same"},{"line_number":3506,"context_line":"      host if possible, but if not possible then they should still be scheduled"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"ba5201f7_17abc48a","line":3503,"range":{"start_line":3502,"start_character":35,"end_line":3503,"end_character":58},"updated":"2016-12-30 08:28:02.000000000","message":"The actual logic makes a bit more stricter promise. Besides that this policy avoids build failure it also minimizes the number of servers from this group on every host. \nOr we can say that this policy spreads the servers in this group to as many host as possible while still avoids build failures.","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"994974db0f7623c1ad7685cfc64a84b2d2667587","unresolved":false,"context_lines":[{"line_number":3503,"context_line":"      be scheduled instead of resulting in a build failure. This policy was"},{"line_number":3504,"context_line":"      added in microversion 2.15."},{"line_number":3505,"context_line":"    - ``soft-affinity`` - servers in this group should be scheduled to the same"},{"line_number":3506,"context_line":"      host if possible, but if not possible then they should still be scheduled"},{"line_number":3507,"context_line":"      instead of resulting in a build failure. This policy was added in"},{"line_number":3508,"context_line":"      microversion 2.15."},{"line_number":3509,"context_line":"  in: body"},{"line_number":3510,"context_line":"  required: true"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"ba5201f7_d7877c10","line":3507,"range":{"start_line":3506,"start_character":24,"end_line":3507,"end_character":46},"updated":"2016-12-30 08:28:02.000000000","message":"Similarly to the above comment we can be a bit stricter here. This policy stacks the servers in this group to the least amount of hosts while still avoids build failures.","commit_id":"0a3f5dca2ca8c0316f0a4d8eb9cb378c52102e87"}]}