DOCS-11817: clarify single-version downgrade (#2188)

jeff-allen-mongo · jeff-allen-mongo · commit b90e1c737bfd · 2022-11-23T11:39:37.000-05:00
* clarify single-version downgrade

* fix include replacements

* update 6.0 downgrade pages

* update 5.0 downgrade instructions

* fix build warnings

* update 4.4 downgrade pages

* update language and use replacements

* language

* use correct include for standalone pages

* grammar

* remove extra include file

* updates per review

* formatting
diff --git a/source/includes/downgrade-path.rst b/source/includes/downgrade-path.rst
@@ -1,3 +1,4 @@
 .. include:: /includes/upgrade-downgrade-replica-set.rst
 
-Once upgraded to |newversion|, if you need to downgrade, we recommend |downgrading| to the latest patch release of |downgradeversion|.
+If you need to downgrade from |newversion|, downgrade to the latest
+patch release of |downgradeversion|.
diff --git a/source/includes/downgrade/latest-patch-release.rst b/source/includes/downgrade/latest-patch-release.rst
@@ -0,0 +1,2 @@
+If you need to downgrade from |newversion|, downgrade to the latest
+patch release of |downgradeversion|.
diff --git a/source/includes/downgrade/single-version-support.rst b/source/includes/downgrade/single-version-support.rst
@@ -0,0 +1,5 @@
+MongoDB only supports single-version downgrades. You cannot downgrade to
+a release that is multiple versions behind your current release. You may
+downgrade a |newseries| to a |oldseries| deployment, however, further
+downgrading that |oldseries| deployment to a |olderseries| deployment is
+not supported.
diff --git a/source/release-notes/4.4-downgrade-replica-set.txt b/source/release-notes/4.4-downgrade-replica-set.txt
@@ -24,6 +24,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. include:: /includes/extracts/4.4-changes-downgrade-floor.rst
 
 Create Backup
@@ -184,5 +186,3 @@ Procedure
    features for each node before downgrading.
 
 .. include:: /includes/steps/4.4-downgrade-replica-set.rst
-
-
diff --git a/source/release-notes/4.4-downgrade-sharded-cluster.txt b/source/release-notes/4.4-downgrade-sharded-cluster.txt
@@ -22,6 +22,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. include:: /includes/extracts/4.4-changes-downgrade-floor.rst
 
 .. |downgrading| replace:: downgrading
diff --git a/source/release-notes/4.4-downgrade-standalone.txt b/source/release-notes/4.4-downgrade-standalone.txt
@@ -20,7 +20,9 @@ of this document.
 Downgrade Path
 --------------
 
-.. include:: /includes/downgrade-path.rst
+.. include:: /includes/downgrade/latest-patch-release.rst
+
+.. include:: /includes/downgrade/single-version-support.rst
 
 .. include:: /includes/extracts/4.4-changes-downgrade-floor.rst
 
diff --git a/source/release-notes/4.4-downgrade.txt b/source/release-notes/4.4-downgrade.txt
@@ -26,6 +26,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. include:: /includes/extracts/4.4-changes-downgrade-floor.rst
 
 .. |downgrading| replace:: downgrading
diff --git a/source/release-notes/5.0-downgrade-replica-set.txt b/source/release-notes/5.0-downgrade-replica-set.txt
@@ -22,6 +22,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 Create Backup
 -------------
 
@@ -209,5 +211,3 @@ Procedure
    features for each node before downgrading.
 
 .. include:: /includes/steps/5.0-downgrade-replica-set.rst
-
-
diff --git a/source/release-notes/5.0-downgrade-sharded-cluster.txt b/source/release-notes/5.0-downgrade-sharded-cluster.txt
@@ -20,6 +20,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. |downgrading| replace:: downgrading
 
 
diff --git a/source/release-notes/5.0-downgrade-standalone.txt b/source/release-notes/5.0-downgrade-standalone.txt
@@ -18,7 +18,9 @@ of this document.
 Downgrade Path
 --------------
 
-.. include:: /includes/downgrade-path.rst
+.. include:: /includes/downgrade/latest-patch-release.rst
+
+.. include:: /includes/downgrade/single-version-support.rst
 
 .. |downgrading| replace:: downgrading
 
diff --git a/source/release-notes/5.0-downgrade.txt b/source/release-notes/5.0-downgrade.txt
@@ -26,6 +26,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. |downgrading| replace:: downgrading
 
 Create Backup
diff --git a/source/release-notes/6.0-downgrade-replica-set.txt b/source/release-notes/6.0-downgrade-replica-set.txt
@@ -24,6 +24,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 Access Control
 --------------
 
diff --git a/source/release-notes/6.0-downgrade-sharded-cluster.txt b/source/release-notes/6.0-downgrade-sharded-cluster.txt
@@ -26,8 +26,9 @@ Downgrade Path
    cluster members are running. If you do not, the upgrade or downgrade
    will not complete until all members are started.
 
-After upgrading to |newversion|, if you need to downgrade, we recommend
-|downgrading| to the latest patch release of |downgradeversion|.
+.. include:: /includes/downgrade/latest-patch-release.rst
+
+.. include:: /includes/downgrade/single-version-support.rst
 
 .. |downgrading| replace:: downgrading
 
diff --git a/source/release-notes/6.0-downgrade-standalone.txt b/source/release-notes/6.0-downgrade-standalone.txt
@@ -20,8 +20,9 @@ in this page.
 Downgrade Path
 --------------
 
-After upgrading to |newversion|, if you need to downgrade, we recommend
-downgrading to the latest patch release of |downgradeversion|.
+.. include:: /includes/downgrade/latest-patch-release.rst
+
+.. include:: /includes/downgrade/single-version-support.rst
 
 .. |downgrading| replace:: downgrading
 
diff --git a/source/release-notes/6.0-downgrade.txt b/source/release-notes/6.0-downgrade.txt
@@ -20,6 +20,8 @@ Downgrade Path
 
 .. include:: /includes/downgrade-path.rst
 
+.. include:: /includes/downgrade/single-version-support.rst
+
 .. |downgrading| replace:: downgrading
 
 Procedures

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+If you need to downgrade from \|newversion\|, downgrade to the latest`
	`2`	`+patch release of \|downgradeversion\|.`