docs-onboarding/versioning.md

23 lines
813 B
Markdown

# Versioning
We utilize a hybrid versioning scheme, blending [Semantic Versioning](https://semver.org/) with [CalVer](https://calver.org/):
```text
YYYY-MM-[RELEASE_TYPE]-N
```
Components of the version number are as follows:
- `YYYY`, `MM`: Year and month of release.
- `RELEASE_TYPE`: Specifies the development stage:
- `alpha`: Initial testing phase.
- `beta`: Near-complete features, further testing.
- `rc` (release candidate): Stability testing, bug fixes.
- `final`: Production-ready release.
- `N`: Incremental release number for multiple releases within one month.
Guidelines:
- Automated scripts should generate version numbers to avoid errors.
- Ensure tool compatibility with the hybrid version format.
- Maintain detailed changelogs for transparency on progression from alpha to final.