
<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">

</head>

<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">

On Apr 20, 2015, at 7:07 PM, Ian Wells <<a href="mailto:ijw.ubuntu@cack.org.uk">ijw.ubuntu@cack.org.uk</a>> wrote:<br>

<div><br class="Apple-interchange-newline">

<blockquote type="cite">

<div dir="ltr">On 20 April 2015 at 15:23, Matthew Treinish <span dir="ltr"><<a href="mailto:mtreinish@kortar.org" target="_blank">mtreinish@kortar.org</a>></span> wrote:<br>

<div class="gmail_extra">

<div class="gmail_quote">

<blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex; position: static; z-index: auto;">

<div class="HOEnZb">

<div class="h5">On Mon, Apr 20, 2015 at 03:10:40PM -0700, Ian Wells wrote:<br>

> It would be nice to have a consistent policy here; it would make future<br>

> decision making easier and it would make it easier to write specs if we<br>

> knew what was expected and the possible implementations weren't up for<br>

> (quite so much) debate.  For different reasons, Neutron extensions are also<br>

> not favoured, so there's no clear cut choice to make.<br>

<br>

</div>

</div>

Uhm, there is: <a href="https://wiki.openstack.org/wiki/APIChangeGuidelines" target="_blank">

https://wiki.openstack.org/wiki/APIChangeGuidelines</a><br>

and if you read that adding attrs without advertising it (using an<br>

extension, microversion, or whatever) is not an allowed change.</blockquote>

<div><br>

</div>

<div>It is also not an unallowed change (given that there's a section that appears to define what an unallowed attribute change is).  The page reads very awkwardly.<br>

<br>

Whatever your preference might be, I think it's best we lose the ambiguity.  And perhaps advertise that page a little more widely, actually - I hadn't come across it in my travels.  And perhaps improve its air of authority: rules on this subject should probably

 live somewhere in a repo so that it's clear there's consensus for changes.  Currently anyone can change it for any reason, and two years after the last substantive change it's hard to say who even knew it was being changed, let alone whether they agreed.<br>

</div>

</div>

</div>

</div>

</blockquote>

<div><br>

</div>

<div>Such a repo exists! [1]</div>

<div><br>

</div>

<div>You can see those docs rendered here. [2]</div>

<div><br>

</div>

<div>It’s under the purview of the API Working Group. [3] You’re most welcome to join us.</div>

<div><br>

</div>

<div>That APIChangeGuidelines wiki page really needs to be incorporated into the official repo [1]. I’ve added that as an agenda item to our next meeting on Thursday 2015-04-23 at 00:00 UTC [4]. </div>

<div><br>

</div>

<div>[1] <a href="http://git.openstack.org/cgit/openstack/api-wg/">http://git.openstack.org/cgit/openstack/api-wg/</a></div>

<div>[2] <a href="http://specs.openstack.org/openstack/api-wg/">http://specs.openstack.org/openstack/api-wg/</a></div>

<div>[3] <a href="https://wiki.openstack.org/wiki/API_Working_Group">https://wiki.openstack.org/wiki/API_Working_Group</a></div>

<div>[4] <a href="https://wiki.openstack.org/wiki/Meetings/API-WG">https://wiki.openstack.org/wiki/Meetings/API-WG</a></div>

<div><br>

</div>

</div>

</body>

</html>