<div dir="ltr">I'll attempt to answer as if it's a quiz and then Russell can tell us what's right and wrong when he gets back online Aussie time. :)<br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jun 29, 2015 at 8:03 AM, Karen Bradshaw <span dir="ltr"><<a href="mailto:kbhawkey@gmail.com" target="_blank">kbhawkey@gmail.com</a>></span> wrote:<br><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 dir="ltr"><div dir="ltr" style="font-size:12.8000001907349px">Hi, Russell.  I just started to look at this code but thought of a few questions,<div>1) How did you validate the generated swagger-json files?</div></div></div></blockquote><div><br></div><div>Typically you'd use the JSON schema from Swagger itself, see <a href="https://github.com/swagger-api/swagger-spec/blob/master/schemas/v2.0/schema.json">https://github.com/swagger-api/swagger-spec/blob/master/schemas/v2.0/schema.json</a></div><div><br></div><div>However he noted the need for a new schema, which you mention below.</div><div> </div><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 dir="ltr"><div dir="ltr" style="font-size:12.8000001907349px"><div>2) Did you create a new schema, Swagger 2.0-OpenStack?  What </div><div>does it look like?</div></div></div></blockquote><div><br></div><div>It doesn't exist yet, so we'll need to make it.</div><div> </div><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 dir="ltr"><div dir="ltr" style="font-size:12.8000001907349px"><div>3) Can you elaborate a bit more about the tagging system?</div></div></div></blockquote><div><br></div><div>I think Tags in Swagger are per-route. A route is a method (like GET or POST) plus a path (like {tenant_id}/servers/detail).</div><div><br></div><div>However we have groups of Tags for say, "Servers" that has a lot of conceptual information in it: <a href="http://developer.openstack.org/api-ref-compute-v2.html#compute_servers">http://developer.openstack.org/api-ref-compute-v2.html#compute_servers</a> So we need a way to group Tags so that we can insert the conceptual information where it makes sense.</div><div><br></div><div>And yes, I believe that's the "narrative doc" we talked about at the Summit. </div><div><br></div><div>Hope that helps - and hopefully Russell fills in the blanks I've left.</div><div><br></div><div>Anne</div><div><br></div><div><br></div><div> </div><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 dir="ltr"><div dir="ltr" style="font-size:12.8000001907349px"><div>Thanks!</div><span class=""><font color="#888888"><div>-Karen</div><div><br></div></font></span></div></div>
<br>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>