<div dir="ltr">Hi Everett,<div><br></div><div>Great to see things moving with the API Working Group!<br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 9, 2014 at 9:35 AM, Everett Toews <span dir="ltr"><<a href="mailto:everett.toews@rackspace.com" target="_blank">everett.toews@rackspace.com</a>></span> wrote:<br><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"><a href="https://wiki.openstack.org/wiki/API_Working_Group" target="_blank">https://wiki.openstack.org/wiki/API_Working_Group</a><br>
<br>
This is the start of the API Working Group (API WG).<br>
<br>
To avoid bike shedding over the name of the working group, I decided to title the wiki page API Working Group. Simple, to the point, and avoids loaded terms like standards, best practices, guidelines, conventions, etc.<br>
<br>
The point isn’t what we name it. The point is what action we take about it. I propose the deliverables in the API WG wiki page.<br>
<br></blockquote><div><br></div><div>I agree with what you've written on the wiki page. I think our priority needs to be to flesh out <a href="https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines">https://wiki.openstack.org/wiki/Governance/Proposed/APIGuidelines</a></div><div>so we have something to reference when reviewing specs. At the moment I see that document as something anyone should be able to document a project's API convention even if they conflict with another project for the moment. Once we've got a fair amount of content we can start as a group resolving</div><div>any conflicts. </div><div><br></div><div> </div><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">
Speaking of the wiki page, I wrote it very matter-of-factly. As if this is the way things are. They’re not. The wiki page is just a starting point. If something was missed, add it. If something can be improved, improve it. Let’s try to keep it simple though.<br>
<br></blockquote><div><br></div><div>One problem with API WG members reviewing spec proposals that affect the API is finding the specs in the first place across many different projects repositories.</div><div> <br></div><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">
I invite everyone who chimed in on the original thread [1] that kicked this off to add themselves as a member committed to making the OpenStack APIs better. I’ve Cc’d everyone who asked to be kept in the loop.<br>
<br>
I already see some cross project summit topics [2] on APIs. But frankly, with the number of people committed to this topic, I’d expect there to be more. I encourage everyone to submit more API related sessions with better descriptions and goals about what you want to achieve in those sessions.<br>
<br></blockquote><div><br></div><div>Yea if there is enough content in the API guidelines then perhaps some time can be spent on working on resolving any conflicts in the document so projects know what direction to head in. </div><div><br></div><div>Regards,</div><div><br></div><div> Chris</div></div></div></div></div>