(DOCSP-21797): Update content for v5.3 release (#919)

* (DOCSP-21797): Update content for v5.3 release

* add patch release heading

* cleanup

* add release date for 5.3.1

* remove rc changelog

* formatting

* formatting

* reorder sections

* restructure

* more tweaking

* wording

* copy fix

Author: jeff-allen-mongo

source/includes/fact-mongodb-intro.rst

@@ -8,4 +8,4 @@ The manual describes key concepts in MongoDB such as:
 - Operational and administrative references
 - Tutorials and procedures
 
-.. include:: /includes/in-dev.rst
+.. include:: /includes/rapid-release-short.rst

source/index.txt

@@ -18,7 +18,7 @@ What is MongoDB?
    .. button:: Get started with MongoDB Atlas
       :uri: https://www.mongodb.com/cloud?tck=docs_server
 
-   .. include:: /includes/in-dev.rst
+   .. include:: /includes/fact-mongodb-intro.rst
 
 .. image:: /images/hero.png
    :alt: Homepage hero image

source/release-notes.txt

@@ -18,45 +18,30 @@ Atlas Rapid Releases
    are not supported for use on-premises. For more information, see
    :ref:`release-version-numbers`.
 
-Upcoming Atlas Rapid Release
-````````````````````````````
-
-(*5.3-series*)
-
-:doc:`/release-notes/5.3`
-
-.. include:: /includes/in-dev.rst
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   /release-notes/5.3
-
 Current Atlas Rapid Release
 ```````````````````````````
 
-(*5.2-series*)
+(*5.3-series*)
 
-:doc:`/release-notes/5.2`
+:ref:`release-notes-5.3`
 
 .. toctree::
    :maxdepth: 1
    :hidden:
 
-   /release-notes/5.2
+   /release-notes/5.3
 
 Previous Atlas Rapid Releases
 `````````````````````````````
 
-(*5.1-series*)
-
-:doc:`/release-notes/5.1`
+- :ref:`5.2-series <release-notes-5.2>`
+- :ref:`5.1- series <release-notes-5.1>`
 
 .. toctree::
    :maxdepth: 1
    :hidden:
 
+   /release-notes/5.2
    /release-notes/5.1
 
 Current Stable Release

source/release-notes/5.1.txt

@@ -1,3 +1,5 @@
+.. _release-notes-5.1:
+
 =============================
 Release Notes for MongoDB 5.1
 =============================

source/release-notes/5.2.txt

@@ -1,3 +1,5 @@
+.. _release-notes-5.2:
+
 =============================
 Release Notes for MongoDB 5.2
 =============================

source/release-notes/5.3-compatibility.txt

@@ -10,7 +10,7 @@ Compatibility Changes in MongoDB 5.3
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/in-dev.rst
+.. include:: /includes/rapid-release-short.rst
 
 This page is a work in progress and will be updated with changes
 introduced in 5.3 that can affect compatibility with older versions of

source/release-notes/5.3.txt

@@ -1,3 +1,5 @@
+.. _release-notes-5.3:
+
 =============================
 Release Notes for MongoDB 5.3
 =============================
@@ -10,26 +12,31 @@ Release Notes for MongoDB 5.3
    :depth: 1
    :class: twocols
 
-.. include:: /includes/in-dev.rst
+.. include:: /includes/rapid-release-short.rst
+
+Patch Releases
+--------------
 
-5.3.1 - Upcoming
-~~~~~~~~~~~~~~~~
+5.3.1 - April 6, 2022
+~~~~~~~~~~~~~~~~~~~~~
 
-.. note::
+The first release available for MongoDB 5.3 is 5.3.1. All mentions of
+MongoDB 5.3 features and updates are available in version 5.3.1.
 
-   The first release available for MongoDB 5.3 is 5.3.1. All mentions of
-   MongoDB 5.3 features and updates are available in version 5.3.1.
+For a list of all changes in 5.3.0, see:
 
-   For a list of all 5.3 and 5.3.1 changes see:
+- :ref:`5.3.0-changelog`
 
-   - `All JIRA issues closed in 5.3.0
-     <https://jira.mongodb.org/issues/?jql=project%20in%20(SERVER%2C%20TOOLS%2C%20WT)%20AND%20resolution%20%3D%20Fixed%20AND%20fixVersion%20in%20versionMatch(%225%5C%5C.3%5C%5C.0%22)>`_
+- `All JIRA issues closed in 5.3.0
+  <https://jira.mongodb.org/issues/?jql=project%20in%20(SERVER%2C%20TOOLS%2C%20WT)%20AND%20resolution%20%3D%20Fixed%20AND%20fixVersion%20in%20versionMatch(%225%5C%5C.3%5C%5C.0%22)>`_
 
-   - `All JIRA issues closed in 5.3.1
-     <https://jira.mongodb.org/issues/?jql=project%20in%20(SERVER%2C%20TOOLS%2C%20WT)%20AND%20resolution%20%3D%20Fixed%20AND%20fixVersion%20%3D%205.3.1>`_
+For a list of all changes in 5.3.1, see:
 
 - :ref:`5.3.1-changelog`
-- :ref:`5.3.0-changelog`
+
+- `All JIRA issues closed in 5.3.1
+  <https://jira.mongodb.org/issues/?jql=project%20in%20(SERVER%2C%20TOOLS%2C%20WT)%20AND%20resolution%20%3D%20Fixed%20AND%20fixVersion%20%3D%205.3.1>`_
+
 
 .. _5.3-rel-notes-aggregation:
 
@@ -71,6 +78,36 @@ MongoDB 5.3 introduces the following aggregation operators:
 
 .. include:: /includes/setWindowFields-and-transactions-snapshots.rst
 
+.. _5.3-rel-notes-security:
+
+Security
+--------
+
+KMIP Key Activation
+~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 5.3, :setting:`security.kmip.activateKeys` activates all 
+newly created KMIP keys upon creation and then periodically checks that 
+keys are in an active state. 
+
+Polling for Active State Keys
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 5.3, :setting:`security.kmip.keyStatePollingSeconds` sets 
+the polling interval in seconds at which :binary:`mongod` polls the KMIP server 
+for active keys. 
+
+.. _5.3-rel-notes-sharding:
+
+Sharding
+--------
+
+Starting in MongoDB 5.3, you can use the new
+:parameter:`chunkDefragmentationThrottlingMS` parameter to limit the
+rate of split and merge commands run by the :term:`balancer` when the
+:term:`chunks <chunk>` in a :term:`sharded <sharding>` collection are
+defragmented.
+
 .. _5.3-rel-notes-general:
 
 General Improvements
@@ -81,7 +118,8 @@ Clustered Collections
 
 .. include:: /includes/clustered-collections-introduction.rst
 
-See :ref:`clustered-collections` for the benefits.
+To learn about the benefits compared to a normal collection, see
+:ref:`clustered-collections`.
 
 ``serverStatus`` Output Change
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -109,32 +147,7 @@ Specify a Timeout for Step Up and Step Down Operations
 
 Starting in MongoDB 5.3, the :parameter:`fassertOnLockTimeoutForStepUpDown`
 parameter allows a server that receives a request to step up or down to 
-terminate if it is unable to comply within the timeout. 
-
-KMIP Key Activation
-~~~~~~~~~~~~~~~~~~~
-
-Starting in MongoDB 5.3, :setting:`security.kmip.activateKeys` activates all 
-newly created KMIP keys upon creation and then periodically checks that 
-keys are in an active state. 
-
-Polling for Active State Keys
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Starting in MongoDB 5.3, :setting:`security.kmip.keyStatePollingSeconds` sets 
-the polling interval in seconds at which :binary:`mongod` polls the KMIP server 
-for active keys. 
-
-.. _5.3-rel-notes-sharding:
-
-Sharding
---------
-
-Starting in MongoDB 5.3, you can use the new
-:parameter:`chunkDefragmentationThrottlingMS` parameter to limit the
-rate of split and merge commands run by the :term:`balancer` when the
-:term:`chunks <chunk>` in a :term:`sharded <sharding>` collection are
-defragmented.
+terminate if it is unable to comply within the timeout.
 
 Report an Issue
 ---------------