Open Stack

Hello API WG,

It is nice to see such warm welcoming!

We have started using the flag in order to join the API WG initiative 
and get feedback about our current API and the guidance for future 
improvements.

Current API is described at RTD [1] as a text, but structured form is 
always better for analysis.

I'll take a look at Swagger and think that it is great idea to use it.

Please consider me as a liaison from MagnetoDB project in API WG, I'm 
interested in attending meeting at 1600 UTC.

Thank you!

With best regards,
Ilya Sviridov


[1] http://magnetodb.readthedocs.org/en/latest/api_reference.html




08.12.2014 16:58, Everett Toews пишет:
> Hello MagnetoDB!
>
> During the latest meeting [1] of the API Working Group (WG) we noticed that MagnetoDB made use of the APIImpact flag [2]. That’s excellent and exactly how we were hoping the use of flag as a discovery mechanism would work!
>
> We were wondering if the MagentoDB team would like to designate a cross-project liaison [3] for the API WG?
>
> We would communicate with that person a bit more closely and figure out how we can best help your project. Perhaps they could attend an API WG Meeting [4] to get started.
>
> One thing that came up during the meeting was my suggestion that, if MagnetoDB had an API definition (like Swagger [5]), we could review the API design independently of the source code that implements the API. There are many other benefits of an API definition for documentation, testing, validation, and client creation.
>
> Does an API definition exist for the MagnetoDB API or would you be interested in creating one?
>
> Either way we’d like to hear your thoughts on the subject.
>
> Cheers,
> Everett
>
> P.S. Just to set expectations properly, please note that review of the API by the WG does not endorse the project in any way. We’re just trying to help design better APIs that are consistent with the rest of the OpenStack APIs.
>
> [1] http://eavesdrop.openstack.org/meetings/api_wg/2014/api_wg.2014-12-04-16.01.html
> [2] https://review.openstack.org/#/c/138059/
> [3] https://wiki.openstack.org/wiki/CrossProjectLiaisons#API_Working_Group
> [4] https://wiki.openstack.org/wiki/Meetings/API-WG
> [5] http://swagger.io/
>
>
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>