ARI version numbers loosely follow the semantic versioning guidelines with a few alterations. ARI maintains the usual convention of MAJOR.MINOR.PATCH for numbering, but with the following definition differences:
- MAJOR – changes when a new major version of Asterisk is released
- MINOR – changes when an incompatible API modification is made
- PATCH – changes when backwards compatible updates are made (new additions or bug fixes)
Any time a new major version of Asterisk is released the ARI version number is modified to reflect that. This is done by taking the major ARI number of the last major release of Asterisk, increasing it by one, and then resetting the other numbers to zero. From there the minor and patch version are increased by one when a change (incompatible and compatible respectively) has been made to ARI.
This has the effect of making the ARI version number relative in relation to an associated Asterisk release, and contextual applicable only to that major release of Asterisk.