cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Chip Childers <chip.child...@sungard.com>
Subject Re: registerSSHKeyPair
Date Fri, 23 Aug 2013 13:10:44 GMT
On Thu, Aug 22, 2013 at 08:33:42AM -0400, Sebastien Goasguen wrote:
> 
> On Aug 22, 2013, at 7:57 AM, Harikrishna Patnala <harikrishna.patnala@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.

Mime
View raw message