(DOCSP-42990) Removes nested components in CM- batch 1 reference (#10… (#334)

Backports #333

Author: sarahsimpers

source/includes/api/automation-configuration/backupVersions.rst

@@ -50,11 +50,9 @@ settings, use the :ref:`update-backup-logs` endpoint.
      - string
      - Required
      - Version of the Backup Agent.
+     
+       To learn more, see :doc:`/reference/mongodb-compatibility`.
 
-       .. seealso::
-
-          :doc:`/reference/mongodb-compatibility`
-          
        .. important::
 
           This property is read-only. Any modifications made to this

source/includes/api/automation-configuration/cluster-wide.rst

@@ -43,6 +43,4 @@ replica set or sharded cluster without requiring a :opsmgr:`rolling restart </re
        parameter from its automation configuration, but not from the
        server.
 
-       .. seealso::
-
-          :manual:`changeStreamOptions </reference/cluster-parameters/#mongodb-parameter-param.changeStreamOptions.preAndPostImages.expireAfterSeconds>`. 
+       To learn more, see :manual:`changeStreamOptions </reference/cluster-parameters/#mongodb-parameter-param.changeStreamOptions.preAndPostImages.expireAfterSeconds>`. 

source/includes/api/automation-configuration/indexConfigs.rst

@@ -98,9 +98,8 @@ The **indexConfigs** array is optional and defines indexes to be built for speci
        This parameter applies only if you set
        **indexConfigs.collation.strength** to **1** or **2**.
 
-       .. seealso::
+       To learn more, see :manual:`Collation </reference/collation>`.
 
-          :manual:`Collation </reference/collation>`
    * - indexConfigs.collation.caseFirst
      - string
      - Optional
@@ -141,9 +140,8 @@ The **indexConfigs** array is optional and defines indexes to be built for speci
 
        The default is **false**.
 
-       .. seealso::
+       To learn more, see :manual:`Collation </reference/collation>`.
 
-          :manual:`Collation </reference/collation>`
    * - indexConfigs.collation.alternate
      - string
      - Optional
@@ -172,9 +170,8 @@ The **indexConfigs** array is optional and defines indexes to be built for speci
 
        The default is **false**.
 
-       .. seealso::
-
-          :manual:`Collation </reference/collation>`
+       To learn more, see :manual:`Collation </reference/collation>`.
+       
    * - indexConfigs.collation.backwards
      - boolean
      - Optional
@@ -186,9 +183,8 @@ The **indexConfigs** array is optional and defines indexes to be built for speci
 
        The default is **false**.
 
-       .. seealso::
-
-          :manual:`Collation </reference/collation>`
+       To learn more, see :manual:`Collation </reference/collation>`.
+       
    * - indexConfigs.options
      - document
      - Required

source/includes/api/automation-configuration/monitoringVersions.rst

@@ -51,11 +51,9 @@ endpoint.
      - string
      - Required
      - Version of the Monitoring Agent.
+     
+       To learn more, see :doc:`/reference/mongodb-compatibility`.
 
-       .. seealso::
-
-          :doc:`/reference/mongodb-compatibility`
-          
        .. important::
 
           This property is read-only. Any modifications made to this

source/includes/api/automation-configuration/processes.rst

@@ -67,11 +67,9 @@ instances. Using this array, you can:
      - Required
      - MongoDB configuration object for MongoDB versions 2.6 and later.
 
-       .. note::
-
-          The ``processes.args2_6`` object accepts most MongoDB 
-          settings and parameters for MongoDB versions 2.6 and later. 
-          To learn more, see :ref:`om-unsupported-mdb-settings`.
+       The ``processes.args2_6`` object accepts most MongoDB 
+       settings and parameters for MongoDB versions 2.6 and later. 
+       To learn more, see :ref:`om-unsupported-mdb-settings`.
 
    * - processes[n].alias
      - string
@@ -93,10 +91,8 @@ instances. Using this array, you can:
        - MongoDB 3.x and 4.x clusters default to **5**.
        - MongoDB 2.6 clusters default to  **3**.
 
-       .. seealso::
-
-          :manual:`Upgrade to SCRAM-SHA-1 </release-notes/3.0-scram/>`
-          in the MongoDB 3.0 release notes.
+       To learn more, see :manual:`Upgrade to SCRAM-SHA-1 
+       </release-notes/3.0-scram/>` in the MongoDB 3.0 release notes.
 
    * - processes[n].backupRestoreUrl
      - string
@@ -105,9 +101,7 @@ instances. Using this array, you can:
        restore. To cancel an in-progress restore operation, set this
        option to ``CANCEL``.
 
-       .. seealso::
-
-          :doc:`/tutorial/automate-backup-restoration-with-api`.
+       To learn more, see :doc:`/tutorial/automate-backup-restoration-with-api`.
 
    * - processes[n].cluster
      - string
@@ -183,9 +177,7 @@ instances. Using this array, you can:
        - |mms| doesn't automatically increment this parameter when you
          upgrade a host from one MongoDB version to the next.
 
-       .. seealso::
-
-          :manual:`setFeatureCompatibilityVersion </reference/command/setFeatureCompatibilityVersion/#dbcmd.setFeatureCompatibilityVersion>`
+       To learn more, see :manual:`setFeatureCompatibilityVersion </reference/command/setFeatureCompatibilityVersion/#dbcmd.setFeatureCompatibilityVersion>`.
 
    * - processes[n].hostname
      - string
@@ -237,29 +229,24 @@ instances. Using this array, you can:
        To trigger the init sync process on the node immediately, set
        this value to the current time as an |iso8601| timestamp.
 
-       .. warning::
-
-          Use this parameter with caution. During
-          :manual:`initial sync </core/replica-set-sync/#replica-set-initial-sync>`,
-          Automation removes the entire contents of the node's
-          ``dbPath`` directory.
+       :red:`WARNING:` Use this parameter with caution. During
+       :manual:`initial sync </core/replica-set-sync/#replica-set-initial-sync>`, Automation removes the entire
+       contents of the node's ``dbPath`` directory.
 
        If you set this parameter:
 
        - On the secondary node, the {+mdbagent+} checks whether the
          specified timestamp is later than the time of the last resync,
          and if confirmed, starts init sync on this node.
 
-         .. example::
-
-            To set **processes.lastResync** on the secondary node to 28
-            May 2021 at 2:43:52 PM US CentralStandard Time, use:
+         For example, to set ``processes.lastResync`` on the secondary node to 28
+         May 2021 at 2:43:52 PM US CentralStandard Time, use:
 
-            ``"processes.lastResync" : "2021-05-28T14:43:52-06:00"``.
+         ``"processes.lastResync" : "2021-05-28T14:43:52-06:00"``
 
-            If the {+mdbagent+} confirms that this timestamp is later
-            than the recorded time of the last resync, it starts init
-            sync on the node.
+         If the {+mdbagent+} confirms that this timestamp is later
+         than the recorded time of the last resync, it starts init
+         sync on the node.
 
        - On the primary node, the {+mdbagent+} waits until you ask the
          primary node to become the secondary with the
@@ -275,9 +262,7 @@ instances. Using this array, you can:
          :method:`rs.stepDown` method, and then starts init sync on
          this node.
 
-       .. seealso::
-
-          :manual:`Initial Sync </core/replica-set-sync/#replica-set-initial-sync>`
+       To learn more, see :manual:`Initial Sync </core/replica-set-sync/#replica-set-initial-sync>`.
 
    * - processes[n].lastKmipMasterKeyRotation
      - string

source/includes/api/automation-configuration/replicaSets.rst

@@ -74,9 +74,8 @@ This field is required for deployments with replica sets.
        configuration document: **_id**; **version**; and
        **members**.
 
-       .. seealso::
+       To learn more, see :manual:`replSetGetConfig </reference/command/replSetGetConfig>`.
 
-          :manual:`replSetGetConfig </reference/command/replSetGetConfig>`
    * - replicaSets[n]._id
      - string
      - Required
@@ -96,9 +95,8 @@ This field is required for deployments with replica sets.
        **processes.name**. The {+mdbagent+} expands the **host** field
        to create a valid replica set configuration.
 
-       .. seealso::
+       To learn more, see :manual:`replSetGetConfig </reference/command/replSetGetConfig>`.
 
-          :manual:`replSetGetConfig </reference/command/replSetGetConfig>`.
    * - replicaSets[n].members[m]._id
      - integer
      - Optional
@@ -174,10 +172,6 @@ This field is required for deployments with replica sets.
        {+mdbagent+} forces the replica set to use. Set to **-1** to
        force a replica set to accept a new configuration.
 
-       .. warning::
-
-          Forcing a replica set reconfiguration might lead to a
-          :term:`rollback` of majority-committed writes.
-
-          Proceed with caution. Contact |mdb-support| if you have
-          questions about the potential impacts of this operation.
+       :red:`WARNING:` Forcing a replica set reconfiguration might lead
+       to a :term:`rollback` of majority-committed writes. Proceed with caution. Contact |mdb-support| if you have
+       questions about the potential impacts of this operation.

source/includes/api/automation-configuration/roles.rst

@@ -78,9 +78,8 @@ The ``roles`` array is optional and describes user-defined roles.
      - Conditional
      - Actions permitted on the resource.
 
-       .. seealso::
+       To learn more, see :manual:`Privilege Actions </reference/privilege-actions/>`.
 
-          :manual:`Privilege Actions </reference/privilege-actions/>`
    * - roles[n].roles
      - array of documents
      - Conditional

source/includes/api/list-tables/auto-config/auth.rst

@@ -14,9 +14,7 @@
      - Defines :manual:`authentication-related </core/authentication>`
        settings.
 
-       .. note::
-
-          If you omit this parameter, skip the rest of this section.
+       If you omit this parameter, skip the rest of this section.
 
    * - auth.authoritativeSet
      - boolean
@@ -97,10 +95,8 @@
 
        **Required if you enable authentication.**
 
-       .. note::
-
-          This parameter contains more than one element only when 
-          it's configured for both SCRAM-SHA-1 and SCRAM-SHA-256.
+       This parameter contains more than one element only when 
+       it's configured for both SCRAM-SHA-1 and SCRAM-SHA-256.
 
        Specify:
 
@@ -134,10 +130,8 @@
 
        Required if **you enable authentication** and **"auth.disabled" : false**.
 
-       .. note::
-
-          If you change the **auth.key** value, you must change the
-          **auth.keyfile** value.
+       If you change the **auth.key** value, you must change the
+       **auth.keyfile** value.
 
    * - auth.keyfile
      - string
@@ -147,10 +141,8 @@
 
        Required if **you enable authentication** and **"auth.disabled" : false**.
 
-       .. note::
-
-          If you change the **auth.keyfile** value, you must change the
-          **auth.key** value.
+       If you change the **auth.keyfile** value, you must change the
+       **auth.key** value.
 
    * - | auth
        | .newAutoPwd

source/includes/api/list-tables/snapshot-cs-documents.rst

@@ -135,11 +135,8 @@
      - objectId
      - The :abbr:`KMIP (Key Management Interoperability Protocol)`
        master key ID used to encrypt the snapshot data.
-
-       .. note::
-        
-          This parameter appears only if this snapshot has
-          ``parts.encryptionEnabled : true``.
+       ``parts.masterKeyUUID`` appears only if this snapshot has
+       ``parts.encryptionEnabled : true``.
 
    * - parts.mongodVersion
      - string

source/includes/api/list-tables/snapshot-rs-documents.rst

@@ -60,11 +60,9 @@
    * - | ``isPossibly``
        | ``Inconsistent``
      - boolean
-     - Flag that indicates the consistency of this :manual:`snapshot </reference/glossary/#std-term-snapshot>`.
-
-       .. note::
-
-          This appears for :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>` snapshots only.
+     - Flag that indicates the consistency of this :manual:`snapshot </reference/glossary/#std-term-snapshot>`. 
+       ``isPossiblyInconsistent`` appears for
+       :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>` snapshots only.
 
        To take a snapshot of a :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>` in a consistent
        state, the {+bagent+} temporarily turns off the
@@ -131,11 +129,8 @@
 
    * - ``missingShards``
      - array of objects
-     - List of shards that the :manual:`snapshot </reference/glossary/#std-term-snapshot>` is missing.
-
-       .. note::
-
-          This appears for :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>` snapshots only.
+     - List of shards that the :manual:`snapshot </reference/glossary/#std-term-snapshot>` is missing. ``missingShards`` appears for 
+       :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>` snapshots only.
 
        In steady state, this array is empty. If the {+bagent+} cannot
        connect to a shard when a :manual:`snapshot </reference/glossary/#std-term-snapshot>` is created, the shard
@@ -221,12 +216,9 @@
    * - | ``parts``
        | ``.masterKeyUUID``
      - string
-     - |kmip| master key ID used to encrypt the :manual:`snapshot </reference/glossary/#std-term-snapshot>` data.
-
-       .. note::
-        
-          This appears only if this snapshot has
-          ``parts.encryptionEnabled : true``.
+     - |kmip| master key ID used to encrypt the :manual:`snapshot </reference/glossary/#std-term-snapshot>` data. 
+       ``parts.masterKeyUUID`` appears only if this snapshot has
+       ``parts.encryptionEnabled : true``.
 
    * - | ``parts``
        | ``.mongodVersion``

source/includes/extract-new-auto-pwd.rst

@@ -6,8 +6,6 @@
 #. **auth.newAutoPwd** copies over the **auth.autoPwd**
    password automatically.
 
-.. note::
-   
-   You can set this option only when you include SCRAM-SHA-1 
-   or SCRAM-SHA-256 as one of the authentication 
-   mechanisms for the {+aagent+} in **auth.autoAuthMechanisms**.
+You can set this option only when you include SCRAM-SHA-1 
+or SCRAM-SHA-256 as one of the authentication 
+mechanisms for the {+aagent+} in **auth.autoAuthMechanisms**.

source/includes/fact-api-key-redacted.rst

@@ -1,7 +1,5 @@
-.. note::
+After you create a third-party integration that requires an API or 
+integration key, the key appears partially redacted when you: 
 
-   After you create a third-party integration that requires an API or 
-   integration key, the key appears partially redacted when you: 
-
-   - View or edit the alert through the UI.
-   - Query the third-party integration settings through the |api|.
+- View or edit the alert through the UI.
+- Query the third-party integration settings through the |api|.

source/includes/fact-microsoft-redacted.rst

@@ -1,5 +1,3 @@
-.. note::
-
-   When you view or edit the alert for a webhook 
-   notification, the URL appears partially redacted, and the
-   secret appears completely redacted.
+When you view or edit the alert for a webhook 
+notification, the URL appears partially redacted, and the
+secret appears completely redacted.

source/includes/fact-pagerduty-decommission.rst

@@ -1,5 +1,3 @@
-.. note:: 
-
-   All new PagerDuty keys use their `Events API v2 <https://developer.pagerduty.com/docs/ZG9jOjExMDI5NTgw-events-api-v2-overview>`__. 
-   If you have an Events API v1 key, you can continue to use that key 
-   with |mms|. 
+All new PagerDuty keys use their `Events API v2 <https://developer.pagerduty.com/docs/ZG9jOjExMDI5NTgw-events-api-v2-overview>`__. 
+If you have an Events API v1 key, you can continue to use that key 
+with |mms|. 

source/includes/fact-webhook-redacted.rst

@@ -1,5 +1,3 @@
-.. note::
-
-   After creating a webhook notification, the URL will appear
-   partially redacted when you view or edit the alert, and the
-   secret will appear completely redacted.
+After creating a webhook notification, the URL is
+partially redacted when you view or edit the alert, and the
+secret is completely redacted.