Your example would not be backward incompatible. Basically: add only optional parameters, dont remove parameters optional or required.
On Sat, Mar 29, 2014 at 4:29 PM, Demetrius Tsitrelis <demetrius.tsitre...@citrix.com> wrote: > Does that include the request and response? For example, it would be useful > to know why a login failed. Thus I envisioned an (optional) element in the > response which would contain that information. > > Sent from my Windows Phone > ________________________________ > From: Alex Hitchins<mailto:alex.hitch...@shapeblue.com> > Sent: 3/29/2014 8:15 AM > To: dev@cloudstack.apache.org<mailto:dev@cloudstack.apache.org> > Subject: RE: Guidelines for new or changed APIs? > > I don't know of any documentation, however we must ensure backwards > compatibility, so that rather rules out changing existing api method > signatures (adding/removing parameters). > > > > Regards > > Alex Hitchins > > D: +44 1892 523 587 | S: +44 2036 030 540 | M: +44 7788 423 969 > > alex.hitch...@shapeblue.com > > -----Original Message----- > From: Demetrius Tsitrelis [mailto:demetrius.tsitre...@citrix.com] > Sent: 29 March 2014 15:06 > To: dev@cloudstack.apache.org > Subject: Guidelines for new or changed APIs? > > I'd like to propose a few changes. Some adding a parameter to an existing > API and some adding a new API altogether. Is there a document describing ASF > or ACS policies for doing so? > > Sent from my Windows Phone > 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. -- Daan
