Skip to content

Commit 8736d38

Browse files
(DOCSP-20183): Prefer 'lts' to 'major' release (#731)
* (DOCSP-20183): Prefer 'lts' to 'major' release * word tweaks * tweak * updates per review * updates per review
1 parent 9d1c435 commit 8736d38

File tree

1 file changed

+19
-20
lines changed

1 file changed

+19
-20
lines changed

source/reference/versioning.txt

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
MongoDB Versioning
55
==================
66

7+
.. |lts| replace:: Long-Term Support
8+
79
.. important::
810

911
Always upgrade to the latest stable revision of your release series.
@@ -14,18 +16,18 @@ release series and ``Z`` refers to the patch number.
1416
Starting with MongoDB 5.0, MongoDB is released as two different release
1517
series:
1618

17-
- Major Releases
19+
- |lts| Releases
1820
- Rapid Releases
1921

2022
For MongoDB 4.4 and previous, MongoDB used a Production / Development
2123
versioning system. See :ref:`historical-releases`.
2224

23-
Major Releases
25+
|lts| Releases
2426
--------------
2527

26-
Major Releases are made available approximately once a year, and
27-
generally mark the introduction of new features and improvements.
28-
Major Releases are appropriate for all MongoDB deployments.
28+
|lts| Releases are made available approximately once a year, and
29+
introduce new features and improvements. |lts| Releases are supported
30+
for MongoDB Atlas and on-premises deployments.
2931

3032
*Example versions:*
3133

@@ -35,17 +37,14 @@ Major Releases are appropriate for all MongoDB deployments.
3537
Rapid Releases
3638
--------------
3739

38-
Rapid Releases are made available approximately once each quarter
39-
that does not contain a Major Release, and generally mark the
40-
introduction of new features and improvements. Rapid Releases are
41-
designed for use with `MongoDB Atlas
40+
Rapid Releases are made available approximately once each quarter that
41+
does not contain a |lts| Release, and introduce new features and
42+
improvements. Rapid Releases are only supported within `MongoDB Atlas
4243
<https://www.mongodb.com/cloud/atlas?tck=docs_server>`_, and are not
43-
generally supported for use in an on-premise capacity. Rapid Releases
44-
are not available for use with `MongoDB Ops Manager
45-
<https://docs.opsmanager.mongodb.com/current/?tck=docs_server>`_, and
46-
are not supported for :ref:`arbiters <replica-set-arbiters>`. If
47-
arbiters are part of your MongoDB deployment, use the most recent
48-
Major Release instead.
44+
supported for on-premises deployments.
45+
46+
Rapid Releases are not available for use with `MongoDB Ops Manager
47+
<https://docs.opsmanager.mongodb.com/current/?tck=docs_server>`_.
4948

5049
*Example versions:*
5150

@@ -56,19 +55,19 @@ Major Release instead.
5655
Patch Releases
5756
--------------
5857

59-
Patch Releases are made available as needed to both
60-
Major Releases and Rapid Releases, and generally
61-
include bug fixes and backwards-compatible changes.
58+
Patch Releases are made available as needed to both |lts| Releases and
59+
Rapid Releases. Patch releases generally include bug fixes and minor
60+
improvements.
6261

6362
*Example versions:*
6463

65-
- ``5.0.1`` (a Major Release patch version)
64+
- ``5.0.1`` (a |lts| Release patch version)
6665
- ``5.2.1`` (a Rapid Release patch version)
6766

6867
Release Candidate (RC) Releases
6968
-------------------------------
7069

71-
In advance of new Major Releases or Rapid Releases, Release Candidates
70+
In advance of new |lts| Releases and Rapid Releases, Release Candidates
7271
are made available for early testing. A Release Candidate represents a
7372
version of the upcoming release that is stable enough to begin testing,
7473
but is not suitable for production deployment.

0 commit comments

Comments
 (0)