[openstack-dev] The API WG mission statement

Stefano Maffulli stefano at openstack.org
Mon Feb 2 19:51:36 UTC 2015


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.

more or less...

/stef




More information about the OpenStack-dev mailing list