<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 03/01/2013 11:04 PM, Dolph Mathews
wrote:<br>
</div>
<blockquote
cite="mid:CAC=h7gXcun-VGDpxaA8HsyiTUr617Wd7g62aFWbW4gTEuzr29g@mail.gmail.com"
type="cite"><br>
<br>
On Friday, March 1, 2013, Adam Young wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">We currently
list the V2 API as Beta. Its time to change that.<br>
<br>
What do we need to do in order to make this legit? Biggest
thing I know of is to document the token API.</blockquote>
<div><br>
</div>
<div>Our 300 Multiple Choice response indicates it's beta. It
should have been stable for both Essex and Folsom. In light of
v3, it should be considered deprecated instead.</div>
</blockquote>
Stable for Grizzly, Deprecated for Havana. <br>
<br>
V3 Should be Stable as well.<br>
<br>
<blockquote
cite="mid:CAC=h7gXcun-VGDpxaA8HsyiTUr617Wd7g62aFWbW4gTEuzr29g@mail.gmail.com"
type="cite">
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
I have a task to document the additional calls for the PKI
tokens. Those are:<br>
<br>
GET /certificates/signing<br>
and<br>
GET /certificates/ca<br>
<br>
But I am not quite certain where to put the docs.<br>
<br>
The docs in keystone/docs/source Seem to be lacking. There is
the curl example page:<br>
<br>
<a moz-do-not-send="true"
href="http://docs.openstack.org/developer/keystone/api_curl_examples.html#id3"
target="_blank">http://docs.openstack.org/developer/keystone/api_curl_examples.html#id3</a><br>
<br>
</blockquote>
<div><br>
</div>
<div>Curl examples were originally written before there was a
client. I think they can be killed soon.</div>
</blockquote>
No, lets plan on keeping them. They are extremely valuable. Many
people are doing direct web integration, from Javascript and other
languages that are not Python. <br>
<br>
<br>
<blockquote
cite="mid:CAC=h7gXcun-VGDpxaA8HsyiTUr617Wd7g62aFWbW4gTEuzr29g@mail.gmail.com"
type="cite">
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
I don't think what that returns is accurate. We have a slew of
Metatdata things in the token now-a-days.<br>
<br>
<br>
There is also the Identity API docs<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/openstack/identity-api/tree/master/openstack-identity-api/src/docbkx"
target="_blank">https://github.com/openstack/identity-api/tree/master/openstack-identity-api/src/docbkx</a>
<br>
<br>
I have not yet identified what the state of the WADL is:<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/openstack/identity-api/blob/master/openstack-identity-api/src/docbkx/admin/identity-admin.wadl"
target="_blank">https://github.com/openstack/identity-api/blob/master/openstack-identity-api/src/docbkx/admin/identity-admin.wadl</a>
<br>
<br>
<br>
</blockquote>
<div><br>
</div>
<div>The official documentation for v2 is this WADL and the
referenced XSD's. there's a separate WADL for the public API.</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
What do we need to do documentation wise before Grizzly Goes GA?<br>
<br>
Also, what will happen with the Markdown for the V3 API? I've
run an HTML transform on it, and it looks very simplistic. I
assume there is a style sheet, but where is it?</blockquote>
<div><br>
</div>
<div>Anne asked us to write markdown because she had a plan for
rendering it to either <a moz-do-not-send="true"
href="http://docs.openstack.org">docs.openstack.org</a> or <a
moz-do-not-send="true" href="http://api.openstack.org">api.openstack.org</a>
-- I assume the style sheets would live in one of <span></span>those
projects, not ours.</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
<br>
<br>
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a moz-do-not-send="true">OpenStack-dev@lists.openstack.org</a><br>
<a moz-do-not-send="true"
href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev"
target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote>
<br>
<br>
-- <br>
<div><br>
</div>
-Dolph<br>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
<pre wrap="">_______________________________________________
OpenStack-dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a>
<a class="moz-txt-link-freetext" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a>
</pre>
</blockquote>
<br>
</body>
</html>