<div dir="ltr">On Wed, Jul 10, 2013 at 8:32 AM, Diane Fleming <span dir="ltr"><<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:<div><br><div class="gmail_extra">
<div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div><div>
<div>For example, in the individual API references, they do appear in the URIs, like this:</div>
<div><br>
</div>
<div><a href="http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html" target="_blank">http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html</a></div>
<div><br>
</div>
<div>However, this same call on the API Reference page looks like this – (see the "List Ids, names, and links for all servers" call)</div>
<div><br>
</div>
<div><a href="http://api.openstack.org/api-ref.html#compute" target="_blank">http://api.openstack.org/api-ref.html#compute</a></div>
<div><br>
</div>
<div>The query parms are described in the table, but don't appear in the URI itself. I find this really confusing. I'd like to have the page changed so that these appear in the URI – what are your thoughts? At the very least, they should be identified as "query"
 parameters in the table. Let me know your thoughts!</div></div></div></div></blockquote><div><br></div><div style>That URL actually refers to many calls, though; Are you suggesting that each call should have its own anchor, such as:</div>
<div style><br></div><div style><a href="http://api.openstack.org/api-ref.html#compute_servers_list">http://api.openstack.org/api-ref.html#compute_servers_list</a></div><div style><a href="http://api.openstack.org/api-ref.html#compute_servers_create">http://api.openstack.org/api-ref.html#compute_servers_create</a></div>
<div style><a href="http://api.openstack.org/api-ref.html#compute_servers_detail">http://api.openstack.org/api-ref.html#compute_servers_detail</a></div><div style><a href="http://api.openstack.org/api-ref.html#compute_servers_delete">http://api.openstack.org/api-ref.html#compute_servers_delete</a></div>
<div style><br></div><div style>I'd be for that.</div><div style><br></div><div style>----  Nick</div><div><br></div><div> </div></div><br></div></div></div>