[openstack-dev] The API WG mission statement
Jay Pipes
jaypipes at gmail.com
Tue Feb 10 03:28:39 UTC 2015
On 02/02/2015 02:51 PM, Stefano Maffulli wrote:
> On Fri, 2015-01-30 at 23:05 +0000, Everett Toews wrote:
>> To converge the OpenStack APIs to a consistent and pragmatic RESTful
>> design by creating guidelines that the projects should follow. The
>> intent is not to create backwards incompatible changes in existing
>> APIs, but to have new APIs and future versions of existing APIs
>> converge.
>
> It's looking good already. I think it would be good also to mention the
> end-recipients of the consistent and pragmatic RESTful design so that
> whoever reads the mission is reminded why that's important. Something
> like:
>
> To improve developer experience converging the OpenStack API to
> a consistent and pragmatic RESTful design. The working group
> creates guidelines that all OpenStack projects should follow,
> avoids introducing backwards incompatible changes in existing
> APIs and promotes convergence of new APIs and future versions of
> existing APIs.
After reading all the mails in this thread, I've decided that Stef's
suggested mission statement above is the one I think best represents
what we're trying to do.
That said, I think it should begin "To improve developer experience *by*
converging" ... :)
Best,
-jay
More information about the OpenStack-dev
mailing list