Hi,<br><br>Seems to me there are two different use cases out there.  Auto-generated docs should be complete/exhaustive "reference" material for what the API has to offer.  Experienced developers will eventually use this only (quick check of syntax for example).  Reference material does not negate the need for useful API docs that get newer developers rolling... including how to use the API, use cases, and practical examples.<br>
<br>My .02,<br>GregD<br><br><div class="gmail_quote">On Wed, Oct 26, 2011 at 9:39 AM, Kevin L. Mitchell <span dir="ltr"><<a href="mailto:kevin.mitchell@rackspace.com">kevin.mitchell@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">On Wed, 2011-10-26 at 12:14 -0400, Jay Pipes wrote:<br>
> That's fine for generating a WADL for existing APIs that are already<br>
> implemented. Not so good for proposed APIs ;)<br>
<br>
Oh, certainly, but there the auto-generation could be used to verify<br>
that the code implements the proposed API :)<br>
<font color="#888888">--<br>
Kevin L. Mitchell <<a href="mailto:kevin.mitchell@rackspace.com">kevin.mitchell@rackspace.com</a>><br>
<br>
<br>
_______________________________________________<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>
</font></blockquote></div><br><br clear="all"><br>-- <br>Regards,<br>Greg DeRenne<br>530/888-7784 (office)<br>530/613-8775 (cell)<br>greg.derenne  (skype)<br>- - -<br><div><span style="font-family:arial, sans-serif;font-size:13px"><span style="background-color:rgb(255, 255, 255)">Register today for the RightScale Conference!<br>
</span>November 8-9, 2011 in </span>Santa Clara, CA</div>


<span style="font-family:arial, sans-serif;font-size:13px"><div><span style="border-collapse:collapse;font-family:arial, sans-serif;font-size:13px"><b><span style="color:rgb(0, 0, 153)"></span></b></span><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:medium"><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:medium"><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:medium"><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-size:medium;font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px"><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-size:medium;font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px"><span style="border-collapse:separate;color:rgb(0, 0, 0);font-family:'Lucida Grande';font-size:medium;font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px"></span></span></span></span></span></span><span style="border-collapse:collapse;font-family:arial, sans-serif;font-size:13px"><b><span style="color:rgb(0, 0, 153)"><span style="color:rgb(0, 0, 102)"></span></span></b></span><span style="border-collapse:collapse;font-family:arial, sans-serif;font-size:13px"></span></div>




<div><div><font color="#888888"><span style="border-collapse:collapse;font-family:arial, sans-serif;font-size:13px"><b><span style="color:rgb(0, 0, 153)"><span style="color:rgb(0, 0, 102)">Real Cloud</span> </span><span style="color:rgb(255, 153, 102)"><span style="color:rgb(255, 102, 0)">Experience</span>. </span><span style="color:rgb(0, 0, 102)">Shared. <br>




</span></b></span></font></div><div><font color="#180a14" size="2"><a href="http://www.rightscale.com/conference" style="color:rgb(42, 93, 176)" target="_blank">http://www.rightscale.com/conference</a></font> <br></div></div>
</span><br><br>