[Openstack] Guidelines for OpenStack APIs

Bryan Taylor btaylor at rackspace.com
Thu Sep 22 18:29:07 UTC 2011


The etherpad thing is already somewhat hard to read. I wonder if we 
could try first to simply get a list of topics that we want guidelines 
on without first trying to say what the standard is. My experience 
trying to come up with such standards internally is that they will 
generate a huge amount of discussion.

Also, we should have some goals for *why* we are creating standards, so 
that we can push back if people go to far, or defend it if we get push 
back by people who just don't want any standards. We don't want 
standards for standards sake, but standards that delivery some specific 
tangible goals.

On 09/18/2011 10:38 PM, Jonathan Bryce wrote:
> After the mailing list discussion around APIs a few weeks back, several
> community members asked the Project Policy Board to come up with a
> position on APIs. The conclusion of the PPB was that each project's PTL
> will own the definition and implementation of the project's official
> API, and APIs across all OpenStack projects should follow a set of
> guidelines that the PPB will approve. This will allow the APIs to be
> tied to the functionality in the project while ensuring a level of
> consistency and familiarity across all projects for API consumers.
>
> We've started an Etherpad to collect input and comments on suggested
> guidelines. It's a little messy but proposed guidelines are set off with
> an asterisk (*):
>
> http://etherpad.openstack.org/RFC-API-Guidelines
>
> Feel free to add comments on the Etherpad, the list or give me feedback
> directly.
>
> Jonathan.
>
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to     : openstack at lists.launchpad.net
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp

This email may include confidential information. If you received it in error, please delete it.





More information about the Openstack mailing list