<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Sep 24, 2014 at 10:51 PM, Christopher Yeoh <span dir="ltr"><<a href="mailto:cbkyeoh@gmail.com" target="_blank">cbkyeoh@gmail.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"><span>On Wed, 24 Sep 2014 13:05:09 -0400<br>
Jay Pipes <<a href="mailto:jaypipes@gmail.com" target="_blank">jaypipes@gmail.com</a>> wrote:<br>
<br>
> On 09/24/2014 12:48 PM, Everett Toews wrote:<br>
> > On Sep 24, 2014, at 9:42 AM, Dean Troyer <<a href="mailto:dtroyer@gmail.com" target="_blank">dtroyer@gmail.com</a>> wrote:<br>
> ><br>
> >> I'll bring an API consumer's perspective.<br>
> ><br>
> > +1<br>
> ><br>
> > I’d bring an API consumer’s perspective as well.<br>
> ><br>
> > Looks like there’s lots of support for an API WG. What’s the next<br>
> > step?<br>
> ><br>
> > Form a WG under the User Committee [1] or is there something more<br>
> > appropriate?<br>
> ><br>
> > Thanks,<br>
> > Everett<br>
> ><br>
> > [1]<br>
> > <a href="https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups" target="_blank">https://wiki.openstack.org/wiki/Governance/Foundation/UserCommittee#Working_Groups</a><br>
><br>
> Whatever it ends up being, it needs to have some teeth to it.<br>
> Otherwise, we're going to end up in the exact same place we're in<br>
> now, where each project does something slightly different.<br>
<br>
</span>I think its more an issue around actually having guidelines and<br>
educating people where to find them than needing teeth to enforce them.<br>
Where I've seen variation in the APIs in Nova its been primarily because<br>
people haven't known what the conventions are than anything else.<br>
<br></blockquote><div><br></div><div>+1 </div><div><br></div><div>I think the wiki is a great place to get ideas out while we look for a cross-project specs workflow in the meantime. Here's a link to the <span style="font-family:arial,sans-serif;font-size:12.7272720336914px">TC meeting [1] where we talked about creating a</span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px"> </span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px">style</span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px"> </span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px">guide</span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px"> </span><span style="font-family:arial,sans-serif;font-size:12.7272720336914px">similar to this one: </span></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><a href="http://fedoraproject.org/wiki/Cloud_APIs_REST_Style_Guide" target="_blank">http://fedoraproject.org/wiki/Cloud_APIs_REST_Style_Guide</a><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">The goal is to give developers guidance while designing <span>APIs</span> so we're consistent across all the projects. If we don't get this sort of <span>style</span> <span>guide to point people to</span>, we'll continue to experience inconsistency across projects. Let's start on the wiki, talk more at the Summit, and iterate as we go.</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">Anne</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">1. <a href="http://eavesdrop.openstack.org/meetings/tc/2014/tc.2014-06-10-20.03.log.html" target="_blank" style="font-size:12.7272720336914px">http://eavesdrop.openstack.org/meetings/tc/2014/tc.2014-06-10-20.03.log.html</a></div><div><br></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">
Chris<br>
<div><div><br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div></div>