Hey Radhika,

Yes, I'm happy to do what I can (probably mainly harassing other people)

CloudMonkey says that there are 431 API calls (in 4.3 RC1) I recon there are 
409 listed on 
http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_Root_Admin.html

I'll try to find which ones are missing.

I think in terms of the API documentation page, the first thing to do is put 
this headings in alphabetical order!

Regards,

Paul Angus
Cloud Architect
S: +44 20 3603 0540 | M: +447711418784 | T: @CloudyAngus
paul.an...@shapeblue.com

-----Original Message-----
From: Radhika Puthiyetath [mailto:radhika.puthiyet...@citrix.com]
Sent: 30 January 2014 07:48
To: dev@cloudstack.apache.org
Subject: RE: API documentation

Hi Paul,

Yes, API documentation requires a serious revisit. I had initiated a discussion 
months back, and invited volunteers.

A wiki page is created at 
https://cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Sprint+for+Enhancing+API+Documentation
, but nothing beyond that.

If you are interested to volunteer, let's begin.

-Radhika

From: Paul Angus [mailto:paul.an...@shapeblue.com]
Sent: Thursday, January 30, 2014 12:43 PM
To: dev@cloudstack.apache.org
Subject: API documentation

DEVs,

New features are generally cool, but given that the 'engine' of CloudStack is 
the API it seems ridiculous that as a minimum the API documentation isn't kept 
up to date.

The specific example that I'm thinking of is

addvmwaredc

Only by using the UI and following the API calls sent could I find that it 
existed, and then tracked it down in the design documents in the wiki.

I've filed a bug for this one 
(https://issues.apache.org/jira/browse/CLOUDSTACK-5984)

But please can everyone make sure we can all use the features you create by 
documenting them.

Regards

Paul Angus
Senior Consultant / Cloud Architect

[cid:image002.png@01CE1071.C6CC9C10]

S: +44 20 3603 0540<tel:+442036030540> | M: +4<tel:+447968161581>47711418784 | 
T: @CloudyAngus paul.an...@shapeblue.com<mailto:paul.an...@shapeblue.com> | 
www.shapeblue.com<http://www.shapeblue.com/> | 
Twitter:@shapeblue<https://twitter.com/>
ShapeBlue Ltd, 53 Chandos Place, Covent Garden, London, WC2N 4HS

Need Enterprise Grade Support for Apache CloudStack?
Our CloudStack Infrastructure 
Support<http://shapeblue.com/cloudstack-infrastructure-support/> offers the 
best 24/7 SLA for CloudStack Environments.

Apache CloudStack Bootcamp training courses

**NEW!** CloudStack 4.2.1 training<http://shapeblue.com/cloudstack-training/>
18th-19th February 2014, Brazil. 
Classroom<http://shapeblue.com/cloudstack-training/>
17th-23rd March 2014, Region A. Instructor led, 
On-line<http://shapeblue.com/cloudstack-training/>
24th-28th March 2014, Region B. Instructor led, 
On-line<http://shapeblue.com/cloudstack-training/>
16th-20th June 2014, Region A. Instructor led, 
On-line<http://shapeblue.com/cloudstack-training/>
23rd-27th June 2014, Region B. Instructor led, 
On-line<http://shapeblue.com/cloudstack-training/>

This email and any attachments to it may be confidential and are intended 
solely for the use of the individual to whom it is addressed. Any views or 
opinions expressed are solely those of the author and do not necessarily 
represent those of Shape Blue Ltd or related companies. If you are not the 
intended recipient of this email, you must neither take any action based upon 
its contents, nor copy or show it to anyone. Please contact the sender if you 
believe you have received this email in error. Shape Blue Ltd is a company 
incorporated in England & Wales. ShapeBlue Services India LLP is a company 
incorporated in India and is operated under license from Shape Blue Ltd. Shape 
Blue Brasil Consultoria Ltda is a company incorporated in Brasil and is 
operated under license from Shape Blue Ltd. ShapeBlue is a registered trademark.
This email and any attachments to it may be confidential and are intended 
solely for the use of the individual to whom it is addressed. Any views or 
opinions expressed are solely those of the author and do not necessarily 
represent those of Shape Blue Ltd or related companies. If you are not the 
intended recipient of this email, you must neither take any action based upon 
its contents, nor copy or show it to anyone. Please contact the sender if you 
believe you have received this email in error. Shape Blue Ltd is a company 
incorporated in England & Wales. ShapeBlue Services India LLP is a company 
incorporated in India and is operated under license from Shape Blue Ltd. Shape 
Blue Brasil Consultoria Ltda is a company incorporated in Brasil and is 
operated under license from Shape Blue Ltd. ShapeBlue is a registered trademark.

Reply via email to