php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-24 02:27:22 +08:00
Code Issues Packages Projects Releases Wiki Activity

updated versioning policy [skip ci]

Browse Source
This commit is contained in:
Qiang Xue
2014-10-17 22:58:35 -04:00
parent 4d3e4d882a
commit 3f7164ca10
1 changed files with 22 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
docs/internals/versions.md
View File

@@ -1,43 +1,30 @@
Yii version numbering Yii Versioning
===================== ==============
Releases This document summarizes the versioning policy of Yii. In general, Yii follows the [Semantic Versioning](http://semver.org/).
--------
``` ## Patch Releases `2.x.Y`
A.B.C
```
- A = For Yii2 it's always 2. * Maintained on a branch named `2.x`
- B = Major version. Non-BC changes with upgrade instructions. * Mainly contain bug fixes and minor feature enhancements
- C = BC changes and additions. * No major features.
* Must be 100% backward compatible to ensure worry-free upgrade. Only exception is security issues that may require breaking BC.
* Release cycle is around 1 to 2 months.
* No pre-releases (alpha, beta, RC) needed.
* Should be merged back to master branch constantly (at least once every week manually).
Release candidates
------------------
``` ## Minor Releases `2.X.0`
A.B.C-rc
A.B.C-rc2
```
This is when we want to do a release candidate. RC number increments till we're getting a stable release with no * Developed on master branch
critical bugs and backwards incompatibility reports. * Mainly contain new features and bug fixes
* Contain minor features and bug fixes merged from patch releases
* May contain BC-breaking changes which are recorded in `UPGRADE-2.X.md` file
* Release cycle is around 6 to 8 months
* Require pre-releases: `2.X.0-alpha`, `2.X.0-beta`, `2.X.0-rc`
* Requires major news releases and marketing effort.
Alphas and betas
----------------
``` ## Major Releases `X.0.0`
A.B.C-alpha
A.B.C-alpha2
```
Alphas are unstable versions where significant bugs may and probably do exist. API isn't fixed yet and may be changed None in plan.
significantly. `alpha2` etc. may or may not be released based on overall stability of code and API.
```
A.B.C-beta
A.B.C-beta2
```
Beta is more or less stable with less bugs and API instability than alphas. There still could be changes in API but
there should be a significant reason for it.