Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork5.2k
made some small addition about our BC promise and semantic versioning#3644
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Changes fromall commits
File filter
Filter by extension
Conversations
Uh oh!
There was an error while loading.Please reload this page.
Jump to
Uh oh!
There was an error while loading.Please reload this page.
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -4,8 +4,15 @@ The Release Process | ||
This document explains the Symfony release process (Symfony being the code | ||
hosted on the main ``symfony/symfony`` `Git repository`_). | ||
Symfony manages its releases through a *time-based model*; a new Symfony minor | ||
version comes out every *six months*: one in *May* and one in *November*. | ||
.. tip:: | ||
The meaning of "minor" comes from the `Semantic Versioning`_ strategy. | ||
Each minor version sticks to the same very well-defined process where we start | ||
with a development period, followed by a maintenance period. | ||
.. note:: | ||
@@ -18,7 +25,7 @@ release comes out every *six months*: one in *May* and one in *November*. | ||
Development | ||
----------- | ||
Thefirstsix-month period is divided into two phases: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others.Learn more. What does | ||
* *Development*: *Four months* to add new features and to enhance existing | ||
ones; | ||
@@ -36,8 +43,8 @@ final release. | ||
Maintenance | ||
----------- | ||
Each Symfonyminorversion is maintained for a fixed period of time, depending | ||
onthe type of the release. We have two maintenance periods: | ||
* *Bug fixes and security fixes*: During this period, all issues can be fixed. | ||
The end of this period is referenced as being the *end of maintenance* of a | ||
@@ -47,17 +54,17 @@ the type of the release. We have two maintenance periods: | ||
be fixed. The end of this period is referenced as being the *end of | ||
life* of a release. | ||
StandardVersions | ||
~~~~~~~~~~~~~~~~~ | ||
A standardminor versionis maintained for an *eight month* period for bug | ||
fixes,and for a *fourteen month* period for security issue fixes. | ||
Long Term SupportVersions | ||
~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
Every two years, a new Long Term SupportVersion (aka LTSversion) is | ||
published. Each LTSversion is supported for a *three year* period for bug | ||
fixes, and for a *four year* period for security issue fixes. | ||
.. note:: | ||
@@ -109,17 +116,26 @@ This results in very predictable dates and maintenance periods: | ||
use the online `timeline calculator`_. You can also get all data as a JSON | ||
string via a URL like `http://symfony.com/roadmap.json?version=2.x`. | ||
.. tip:: | ||
Whenever an important event related to Symfony versions happens (a version | ||
reaches end of maintenance or a new patch version is released for | ||
instance), you can automatically receive an email notification if you | ||
subscribed on the `roadmap notification`_ page. | ||
Backward Compatibility | ||
---------------------- | ||
Our `Backwards Compatibility Promise`_ is very strict and allows developers to | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others.Learn more. shouldn't this be a | ||
upgrade with confidence from one minor version of Symfony to the next one. | ||
Whenever keeping backward compatibility is not possible, the feature, the | ||
enhancement, or the bug fix will be scheduled for the next major version. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others.Learn more. no comma needed here | ||
.. note:: | ||
The work ona new major version of Symfony startswhenever enough major | ||
features breakingbackward compatibility are waiting on the todo-list. | ||
Deprecations | ||
------------ | ||
@@ -154,11 +170,12 @@ for the next cycle. | ||
The dual maintenance mode was adopted to make every Symfony user happy. Fast | ||
movers, who want to work with the latest and the greatest, use the standard | ||
version: a new version is published every six months, and there is a two months | ||
period to upgrade. Companies wanting more stability use the LTS versions: a new | ||
version is published every two years and there is a year to upgrade. | ||
.. _Semantic Versioning: http://semver.org/ | ||
.. _Git repository: https://github.com/symfony/symfony | ||
.. _SensioLabs: http://sensiolabs.com/ | ||
.. _roadmap notification: http://symfony.com/roadmap | ||
.. _timeline calculator: http://symfony.com/roadmap |