On 10/13/2014 11:10 AM, Russell Bryant wrote:
On 10/10/2014 12:09 PM, Jay Pipes wrote:
Thanks for getting this going, Everett! Comments inline...
On 10/08/2014 07:05 PM, Everett Toews wrote:
https://wiki.openstack.org/wiki/API_Working_Group
This is the start of the API Working Group (API WG).
yay! :)
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.
Yup, ++
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.
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.
The wiki content looks fine, with the exception that I really do feel
the working group needs to have some ability to review and enforce
consistency within proposed REST APIs. The wording right now is:
"The API WG is focused on creating guidelines for the APIs"
which of course is fine, but I think that the Technical Committee should
essentially grant the working group the power to enforce guidelines and
consistency for proposed new REST APIs -- whether it's a new REST API
version in an existing project or a REST APi for a newly-proposed
OpenStack server project.
I think that's a great goal. I'd like to see the group earn this level
of influence based on its own merit rather than have the TC just grant
it up front. I'd say let's give the group a cycle to build up, generate
guidelines, and participate in API design reviews. I'd rather see it as
the TC making something official that was effectively already happening
in practice.
Sure, totally fair point.
Best,
-jay
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev