Hi Mark, <br><div class="gmail_quote"><div> </div><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
However, I question whether it's even being used in this fashion. Looking at our docs for Nova <<a href="http://docs.openstack.org/api/openstack-compute/2/content/" target="_blank">http://docs.openstack.org/api/openstack-compute/2/content/</a>>, the schema isn't locatable, and the XML Namespace <<a href="http://docs.openstack.org/compute/api/v1.1" target="_blank">http://docs.openstack.org/compute/api/v1.1</a>> is a 404. How are they finding the schema, and how is it getting into these tools?<br>


<div class="im"><br>
<br></div></blockquote><div><br>The schema is available at <br><a href="http://docs.openstack.org/api/openstack-compute/2/xsd/">http://docs.openstack.org/api/openstack-compute/2/xsd/</a><br><br>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 <a href="http://bugs.launchpad.net/openstack-manuals/">http://bugs.launchpad.net/openstack-manuals/</a> and tag it with compute-api with specifics about how you think it should work on the docs site.<br>

<br><br></div><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
I'm not talking about *removing* XML from the current APIs that ship it, BTW; at most I'd like to see us:<br>
<br>
1. Not require XML for new APIs, and<br>
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<br>
3. Put some considered caveats around our current use of WADL and XML Schema.<br>
<div class="im HOEnZb"><br></div></blockquote><div><br>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 <a href="http://api.openstack.org">api.openstack.org</a> 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 <a href="http://api.openstack.org">api.openstack.org</a> site first thing Monday morning as well as on a panel about TryStack Thursday afternoon and would love feedback.<br>

<br>Thanks,<br>Anne<br><br><br> </div><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class="im HOEnZb">
Cheers,<br>
<br>
<br>
--<br>
Mark Nottingham<br>
<a href="http://www.mnot.net/" target="_blank">http://www.mnot.net/</a><br>
<br>
<br>
<br>
<br>
<br>
</div><div class="HOEnZb"><div class="h5">_______________________________________________<br>
Mailing list: <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
Post to     : <a href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a><br>
Unsubscribe : <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
More help   : <a href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a><br>
</div></div></blockquote></div><br>