The codebots are released using a variation of semantic versioning to assist in mimising disruptions to a develop cycle whilst also allowing development teams to take advantage of any bot improvements.
The last three digits of a bot version are consistent with the major, minor and patch increments from semantic versioning. The first number represents more major improvements such as support for a new behaviour.
For example, a codebot version number may look like
22.214.171.124. The current version of your codebot for your project can be seen in the Build diagrams.
The general rule of thumb is patches require no migrations (version increments of the fourth digit i.e. 126.96.36.199), minor releases can require migrations that take a few minutes (version increments of the third digit i.e. 188.8.131.52), and major migrations are reserved for version increments of the first two digits.
This is just a guide and it is recommended you refer to the release notes of each new release before upgrading to minimise the impact of any changes.
See C#Bot Versions, and SpringBot Versions for the release notes for each of the bots available.