/ doc / interface_stability.mdwn
interface_stability.mdwn
 1  Propellor is versioned using the Haskell [Package Version Policy](https://www.haskell.org/haskellwiki/Package_versioning_policy).
 2  
 3  This means that propellor 2.10.x contains some changes to its API;
 4  code written for propellor 2.9.x may need to be changed. Conversely,
 5  there are no breaking changes between 2.10.1 and 2.10.2.
 6  
 7  Whenever possible, breaking changes are made in a way that either changes a
 8  data type, or a function name, so that code that used the old API version
 9  won't compile under the new one.
10  
11  Sometimes, changes to the behavior of properties also merit a major version
12  change. For example, propellor 0.8.0 completely revamped the privdata
13  storage, and users had to manually transition.