= Guidelines on API Changes =

 - '''''Always try to maintain API compatibility.'''''
 - If an interface ''must'' be changed, try to maintain the old interface for at
   least one minor (eg. [milestone:0.10] -> [milestone:0.11]) version change and log deprecation
   warnings when it's used. Document the API change in '''!ApiChanges/<version>'''.
 - If the old interface can't be maintained, document it as such in the
   appropriate '''!ApiChanges/<version>''' Wiki page.