On Thu, Aug 22, 2013 at 08:33:42AM -0400, Sebastien Goasguen wrote: > > On Aug 22, 2013, at 7:57 AM, Harikrishna Patnala > <harikrishna.patn...@citrix.com> wrote: > > > We generate docs based on the response object. Since we use the same > > response object for create/register ssh key pair APIs, doc shows same > > return values. > > We follow this for all API responses. Say list virtual machine API response > > does not include all the fields that are in api doc. > > > > I understand, but that's a case where it's misleading. Maybe the response > objects should not be the same after all.
+1 - this is another example of where the CS API leaks implementation details all over the place, in this case manifested as a documentation issue.
