Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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

Closed
fabpot wants to merge1 commit intosymfony:masterfromfabpot:bc-releases
Closed
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 38 additions & 21 deletionscontributing/community/releases.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -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
release comes out every *six months*: one in *May* and one in *November*.
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::

Expand All@@ -18,7 +25,7 @@ release comes out every *six months*: one in *May* and one in *November*.
Development
-----------

The six-months period is divided into two phases:
Thefirstsix-month period is divided into two phases:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

What doesfirst refer to? For me, it implies that there must be a second six-month period.


* *Development*: *Four months* to add new features and to enhance existing
ones;
Expand All@@ -36,8 +43,8 @@ final release.
Maintenance
-----------

Each Symfony version is maintained for a fixed period of time, depending on
the type of the release. We have two maintenance periods:
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
Expand All@@ -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.

StandardReleases
StandardVersions
~~~~~~~~~~~~~~~~~

A standardreleaseis maintained for an *eight month* period for bug fixes,
and for a *fourteen month* period for security issue fixes.
A standardminor versionis maintained for an *eight month* period for bug
fixes,and for a *fourteen month* period for security issue fixes.

Long Term SupportReleases
Long Term SupportVersions
~~~~~~~~~~~~~~~~~~~~~~~~~~

Every two years, a new Long Term SupportRelease (aka LTSrelease) is
published. Each LTSrelease is supported for a *three year* period for bug
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::
Expand DownExpand Up@@ -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
----------------------

After the release of Symfony 2.3, backward compatibility will be kept at all
cost. If it is not possible, the feature, the enhancement, or the bug fix will
be scheduled for the next major version: Symfony 3.0.
Our `Backwards Compatibility Promise`_ is very strict and allows developers to
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

shouldn't this be a:doc: reference ?

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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

no comma needed here


.. note::

The work onSymfony 3.0 will startwhenever enough major features breaking
backward compatibility are waiting on the todo-list.
The work ona new major version of Symfony startswhenever enough major
features breakingbackward compatibility are waiting on the todo-list.

Deprecations
------------
Expand DownExpand Up@@ -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
releases: a new version is published every six months, and there is a two
months period to upgrade. Companies wanting more stability use the LTS
releases: a new version is published every two years and there is a year to
upgrade.
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/
.. _`timeline calculator`: http://symfony.com/roadmap
.. _roadmap notification: http://symfony.com/roadmap
.. _timeline calculator: http://symfony.com/roadmap

[8]ページ先頭

©2009-2025 Movatter.jp