What is Semantic Versioning?

Semantic Versioning (SemVer)is a version numbering scheme that conveys meaning about the underlying changes in each software release.


What do the numbers mean?

Version Change Example What Happened?
Major **2**.5.1 → **3**.0.0 Incompatible change was made
Minor 2.**5**.1 → 2.**6**.0 New feature or deprecation, backward compatible
Patch 2.5.**1** → 2.5.**2** Bug fix without changing features or breaking compatibility

The version number is always in the format:

MAJOR.MINOR.PATCH

Once a version is released, its contents will not be modified. Any changes require a new version.


How do I know if an update is safe to apply?

<aside> <img src="notion://custom_emoji/a584b4e4-92ec-446a-b883-716c24b5cb1c/13e8ef45-35c7-808d-bd45-007a73f594ac" alt="notion://custom_emoji/a584b4e4-92ec-446a-b883-716c24b5cb1c/13e8ef45-35c7-808d-bd45-007a73f594ac" width="40px" />

Apple does not allow developers to hide new versions, including pre-release builds. As a result, Prism Labs’ partners may have visibility into these versions. Please refrain from using them unless explicitly instructed, as they may not be stable.

Refer to Prism Labs Release Notes for details.

</aside>


How do we handle deprecations?

When we deprecate a feature: