2018-07-23 22:29:31 -04:00
|
|
|
**DO NOT READ THIS FILE ON GITHUB, GUIDES ARE PUBLISHED ON https://guides.rubyonrails.org.**
|
2014-12-23 17:32:50 -05:00
|
|
|
|
2013-10-02 18:26:58 -04:00
|
|
|
Maintenance Policy for Ruby on Rails
|
2013-09-09 06:09:38 -04:00
|
|
|
====================================
|
|
|
|
|
|
|
|
|
|
Support of the Rails framework is divided into four groups: New features, bug
|
|
|
|
|
fixes, security issues, and severe security issues. They are handled as
|
2020-05-19 18:02:04 -04:00
|
|
|
follows, all versions, except for security releases, in `X.Y.Z`, format.
|
2013-10-02 18:26:58 -04:00
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
2013-09-09 06:09:38 -04:00
|
|
|
|
2019-10-02 05:54:57 -04:00
|
|
|
Rails follows a shifted version of [semver](https://semver.org/):
|
2014-05-29 22:35:12 -04:00
|
|
|
|
|
|
|
|
**Patch `Z`**
|
|
|
|
|
|
|
|
|
|
Only bug fixes, no API changes, no new features.
|
2014-05-30 10:44:55 -04:00
|
|
|
Except as necessary for security fixes.
|
2014-05-29 22:35:12 -04:00
|
|
|
|
|
|
|
|
**Minor `Y`**
|
|
|
|
|
|
|
|
|
|
New features, may contain API changes (Serve as major versions of Semver).
|
2014-05-30 10:44:55 -04:00
|
|
|
Breaking changes are paired with deprecation notices in the previous minor
|
|
|
|
|
or major release.
|
2014-05-29 22:35:12 -04:00
|
|
|
|
|
|
|
|
**Major `X`**
|
|
|
|
|
|
|
|
|
|
New features, will likely contain API changes. The difference between Rails'
|
|
|
|
|
minor and major releases is the magnitude of breaking changes, and usually
|
|
|
|
|
reserved for special occasions.
|
|
|
|
|
|
2013-09-09 06:09:38 -04:00
|
|
|
New Features
|
|
|
|
|
------------
|
|
|
|
|
|
2021-01-19 15:43:24 -05:00
|
|
|
New features are only added to the main branch and will not be made available
|
2013-09-09 06:09:38 -04:00
|
|
|
in point releases.
|
|
|
|
|
|
2013-10-02 18:26:58 -04:00
|
|
|
Bug Fixes
|
2013-09-09 06:09:38 -04:00
|
|
|
---------
|
|
|
|
|
|
2022-01-05 15:32:49 -05:00
|
|
|
Only the latest release series will receive bug fixes. Bug fixes are typically
|
|
|
|
|
added to the main branch, and backported to the x-y-stable branch of the latest
|
|
|
|
|
release series if there is sufficient need. When enough bugs fixes have been added
|
|
|
|
|
to an x-y-stable branch, a new patch release is built from it. For example, a
|
|
|
|
|
theoretical 1.2.2 patch release would be built from the 1-2-stable branch.
|
2013-09-09 06:09:38 -04:00
|
|
|
|
2014-09-12 14:54:08 -04:00
|
|
|
In special situations, where someone from the Core Team agrees to support more series,
|
|
|
|
|
they are included in the list of supported series.
|
|
|
|
|
|
2021-12-07 10:52:30 -05:00
|
|
|
**Currently included series:** `7.1.Z`.
|
2013-09-09 06:09:38 -04:00
|
|
|
|
2013-10-02 18:26:58 -04:00
|
|
|
Security Issues
|
|
|
|
|
---------------
|
2013-09-09 06:09:38 -04:00
|
|
|
|
|
|
|
|
The current release series and the next most recent one will receive patches
|
|
|
|
|
and new versions in case of a security issue.
|
|
|
|
|
|
|
|
|
|
These releases are created by taking the last released version, applying the
|
|
|
|
|
security patches, and releasing. Those patches are then applied to the end of
|
2020-02-07 04:19:22 -05:00
|
|
|
the x-y-stable branch. For example, a theoretical 1.2.2.1 security release would
|
2013-09-09 06:09:38 -04:00
|
|
|
be built from 1.2.2, and then added to the end of 1-2-stable. This means that
|
|
|
|
|
security releases are easy to upgrade to if you're running the latest version
|
|
|
|
|
of Rails.
|
|
|
|
|
|
2021-02-22 16:18:48 -05:00
|
|
|
Only direct security patches will be included in security releases. Fixes for
|
|
|
|
|
non-security related bugs resulting from a security patch may be published on a
|
|
|
|
|
release's x-y-stable branch, and will only be released as a new gem in
|
|
|
|
|
accordance with the Bug Fixes policy.
|
|
|
|
|
|
2021-12-07 10:52:30 -05:00
|
|
|
**Currently included series:** `7.1.Z`, `7.0.Z`, `6.1.Z`.
|
2013-09-09 06:09:38 -04:00
|
|
|
|
2013-10-02 18:26:58 -04:00
|
|
|
Severe Security Issues
|
|
|
|
|
----------------------
|
2013-09-09 06:09:38 -04:00
|
|
|
|
2018-04-10 18:42:27 -04:00
|
|
|
For severe security issues all releases in the current major series, and also the
|
2019-08-28 05:46:30 -04:00
|
|
|
last release in the previous major series will receive patches and new versions. The
|
2013-09-09 06:09:38 -04:00
|
|
|
classification of the security issue is judged by the core team.
|
|
|
|
|
|
2021-12-07 10:52:30 -05:00
|
|
|
**Currently included series:** `7.1.Z`, `7.0.Z`, `6.1.Z`.
|
2013-09-09 06:09:38 -04:00
|
|
|
|
|
|
|
|
Unsupported Release Series
|
|
|
|
|
--------------------------
|
|
|
|
|
|
|
|
|
|
When a release series is no longer supported, it's your own responsibility to
|
2013-10-02 18:26:58 -04:00
|
|
|
deal with bugs and security issues. We may provide backports of the fixes and
|
2013-09-09 06:09:38 -04:00
|
|
|
publish them to git, however there will be no new versions released. If you are
|
|
|
|
|
not comfortable maintaining your own versions, you should upgrade to a
|
|
|
|
|
supported version.
|
