<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Sep 18, 2013 at 2:54 PM, David Cramer <span dir="ltr"><<a href="mailto:david.cramer@rackspace.com" target="_blank">david.cramer@rackspace.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Ah, excellent! So why is there a separate developer guide that kind-of<br>
has an api reference, but not really? It seems strange to split the<br>
content over the two places.<br>
<br></blockquote><div><br></div><div>Yes - the original idea was that the api-site repo would document reality for end users, and the <project>-api repos would contain specs. </div><div><br></div><div><br></div><div>

<br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Regards,<br>
David<br>
<div class="im"><br>
On 09/18/2013 02:41 PM, Anne Gentle wrote:<br>
> Yep, there is an object-api WADL in the api-site repo.<br>
><br>
> <a href="http://git.openstack.org/cgit/openstack/api-site/tree/api-ref/src/wadls/object-api/src/os-object-api-1.0.wadl" target="_blank">http://git.openstack.org/cgit/openstack/api-site/tree/api-ref/src/wadls/object-api/src/os-object-api-1.0.wadl</a><br>


><br>
> It would be great to get all the headers in it, not sure if it's<br>
> complete. See:<br>
><br>
> <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1193417" target="_blank">https://bugs.launchpad.net/openstack-api-site/+bug/1193417</a><br>
> <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1214136" target="_blank">https://bugs.launchpad.net/openstack-api-site/+bug/1214136</a><br>
> <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1214139" target="_blank">https://bugs.launchpad.net/openstack-api-site/+bug/1214139</a><br>
><br>
> I've asked Catherine Richardson, the Cloud Files writer at Rackspace, to<br>
> work on <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1224562" target="_blank">https://bugs.launchpad.net/openstack-api-site/+bug/1224562</a>.<br>
><br>
><br>
><br>
> Anne<br>
><br>
><br>
> On Wed, Sep 18, 2013 at 2:21 PM, David Cramer<br>
</div><div class="im">> <<a href="mailto:david.cramer@rackspace.com">david.cramer@rackspace.com</a> <mailto:<a href="mailto:david.cramer@rackspace.com">david.cramer@rackspace.com</a>>> wrote:<br>
><br>
>     Hi all,<br>
>     A colleague and are considering using object-api [1] to demonstrate some<br>
>     ideas we have about what complete documentation should look like. To do<br>
>     this, we're planning on creating a wadl for the object-api. I thought<br>
>     I'd check to see if an initial wadl already exists somewhere or is in<br>
>     progress. If not, I plan on creating one (and incorporating material<br>
>     from your existing reference doc). We can then generate the dev guide<br>
>     reference section from it and also use it for the <a href="http://api.openstack.org" target="_blank">api.openstack.org</a><br>
</div>>     <<a href="http://api.openstack.org" target="_blank">http://api.openstack.org</a>> site.<br>
<div class="im">><br>
>     Regards,<br>
>     David<br>
><br>
>     [1] <a href="https://github.com/openstack/object-api" target="_blank">https://github.com/openstack/object-api</a><br>
><br>
>     _______________________________________________<br>
>     Openstack-docs mailing list<br>
>     <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
</div>>     <mailto:<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a>><br>
<div class="im">>     <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
><br>
><br>
><br>
> --<br>
> Anne Gentle<br>
</div>> <a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a> <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
<br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>