[Openstack] Just JSON, and extensibility
Mark Nottingham
mnot at mnot.net
Fri Apr 13 19:18:22 UTC 2012
On 13/04/2012, at 2:04 PM, Anne Gentle wrote:
> Hi Mark,
>
> However, I question whether it's even being used in this fashion. Looking at our docs for Nova <http://docs.openstack.org/api/openstack-compute/2/content/>, the schema isn't locatable, and the XML Namespace <http://docs.openstack.org/compute/api/v1.1> is a 404. How are they finding the schema, and how is it getting into these tools?
>
>
> The schema is available at
> http://docs.openstack.org/api/openstack-compute/2/xsd/
>
> I am told that we don't need to redirect to the XML Namespace as it is just a string not an actual URL. If you disagree, please log a doc bug at http://bugs.launchpad.net/openstack-manuals/ and tag it with compute-api with specifics about how you think it should work on the docs site.
OK.
> I'm not talking about *removing* XML from the current APIs that ship it, BTW; at most I'd like to see us:
>
> 1. Not require XML for new APIs, and
> 2. Talk about deprecating XML support in current ones (i.e., still support it, but de-emphasise it in documentation, don't expend new effort on it), and
> 3. Put some considered caveats around our current use of WADL and XML Schema.
>
>
> One additional comment about WADL - basically one of those caveats. We had little community traction documenting Compute API extensions with various templates. A working solution now is to add extensions to api.openstack.org using WADL and JSON samples. It's one of those examples of elbow grease and a small group adding great value. Next week I'll be doing a "Show-N-Tell" of the api.openstack.org site first thing Monday morning as well as on a panel about TryStack Thursday afternoon and would love feedback.
Yes. I think the api.openstack.org is great and definitely moving in the right direction; should be an interesting discussion.
Cheers,
--
Mark Nottingham
http://www.mnot.net/
More information about the Openstack
mailing list