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 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.
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.
Will do.
Best,
-jay
Regards, Everett
[1]
http://lists.openstack.org/pipermail/openstack-dev/2014-September/046850.html
[2] https://etherpad.openstack.org/p/kilo-crossproject-summit-topics
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
