(DOCSP-43046) [OM] OM nested components group 11 (#398)

## Unnesting components in 19 OM pages. 
[This
spreadsheet](https://docs.google.com/spreadsheets/d/1M2IlsyV0-6mY-AvBBrX-4uSDtQrbt9zuoXsqIJaVqlk/edit?gid=0#gid=0)
tracks the number of nested components on each page, and [this
doc](https://docs.google.com/document/d/1yMbng-EPOQ82bAzBTC2VJwIvsUBOSCJh21cGbDoe1a8/edit#heading=h.7hxlffls9cx6)
provides guidelines for fixing nested components.

## [DOCSP-43046](https://jira.mongodb.org/browse/DOCSP-43046)

## STAGING 
1.
[ops-manager/current/reference/api/kmip-keys/get-master-key/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/kmip-keys/get-master-key/)
— Unnested 1 note in table.
2.
[ops-manager/current/reference/api/kmip-keys/rotate-master-key/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/kmip-keys/get-master-key/)
— Unnested 1 note in table: same note as above.
3.
[ops-manager/current/reference/api/organizations/organization-create-one/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/organizations/organization-create-one/)
— Unnested 1 note in table.
4.
[ops-manager/current/reference/api/diagnostics/get-project-diagnostic-archive/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/diagnostics/get-project-diagnostic-archive/)
— Unnested 1 example in table.
5.
[ops-manager/current/reference/api/backup/get-all-backup-configs-for-group/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/backup/get-all-backup-configs-for-group/)
— Unnested 1 note in table, same note as above (1 and 2)
6.
[ops-manager/current/reference/api/backup/get-one-backup-config-by-cluster-id/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/backup/get-one-backup-config-by-cluster-id/)
— Unnested 1 note in table, same note as above (1 and 2)
7.
[ops-manager/current/reference/api/user-create-first/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/api/user-create-first/)
— Unnested 2 notes in tables.
8.
[ops-manager/current/reference/config/ui-settings/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/config/ui-settings/)
— Unnested 1 example in ``important`` admonition; note: could not find
the 1 admonition in table listed on the spreadsheet
9. [ops-manager/current/reference/configuration/
](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/configuration/)—
Unnested 1 note in ``important`` admonition in DOCSP-43011, unnested 1
``important`` admonition in table and couldn't find the other admonition
in table listed in the spreadsheet, unnested 1 example in table, and
unnested 4 examples in ``important`` admonitions (2 of which were the
same include)
10.
[ops-manager/current/reference/firewall-configuration/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/reference/firewall-configuration/)
— Unnested 1 ``important`` admonition.
11.
[ops-manager/current/release-notes/automation-agent/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/release-notes/automation-agent/)
— Entire page was wrapped in a note-- unindented the page so that the
page is no longer nested.
12.
[ops-manager/current/release-notes/backup-agent/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/release-notes/backup-agent/)
— Unindented page that was wrapped in a note.
13.
[ops-manager/current/tutorial/manage-projects/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/manage-projects/)
— Unnested 1 note in table. Note: Couldn't find 2 admonitions in table
listed in the spreadsheet.
14.
[ops-manager/current/tutorial/manage-s3-blockstore-storage/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/manage-s3-blockstore-storage/)
— Unnested 3 examples and 7 admonitions in tables.
15.
[ops-manager/current/tutorial/manage-s3-oplog-storage/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/manage-s3-oplog-storage/)
— Unnested 2 examples, 2 notes, and 2 ``important`` admonitions in
tables.
16.
[ops-manager/current/tutorial/prepare-backing-mongodb-instances/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/prepare-backing-mongodb-instances/)
— Unnested 1 warning in table.
17.
[ops-manager/current/tutorial/view-logs/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/view-logs/)
— Unnested 3 notes and 1 example in table.
18.
[ops-manager/current/tutorial/update-om-with-latest-version-manifest-with-api/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/update-om-with-latest-version-manifest-with-api/)
— Unnested 1 example in table and 1 example in tip.
19.
[ops-manager/current/tutorial/upgrade-ops-manager/](https://deploy-preview-398--10gen-docs-ops-manager.netlify.app/tutorial/upgrade-ops-manager/)
— Unnested 3 tips and 1 ``important`` admonition in table.

## [LATEST BUILD
LOG](https://app.netlify.com/sites/10gen-docs-ops-manager/deploys/66fc4150994f6a0008c96d81)

### Self-Review Checklist

- [ ]
[Define](https://wiki.corp.mongodb.com/display/DE/Taxonomy+tagging+instructions)
taxonomy
[values](https://wiki.corp.mongodb.com/display/DE/Docs+Taxonomy) at top
of page.
- [ ] Add genre facets (tutorial or reference), as in this [example
PR](10gen/cloud-docs#5042).
- [ ] Add programmingLanguage (if necessary).
- [ ] Add meta keywords (if necessary).
- [x] Resolve any new warnings or errors in the build.
- [x] Proofread for spelling and grammatical errors.
- [x] Check staging for rendering issues.
- [x] Confirm links are working.

---------

Co-authored-by: Elyse Foreman <[email protected]>

Author: elyse-mdb

source/includes/extracts-firewall-configuration.yaml

@@ -86,11 +86,10 @@ content: |
          .. code-block:: http
 
             http://127.0.0.1:8090/health
-
-         .. important::
-            This port is only accessible from ``localhost``
-            (or ``127.0.0.1``). The port number *can* be changed from
-            ``8090`` to another value.
+         
+         :gold:`IMPORTANT:` This port is only accessible from ``localhost``
+         (or ``127.0.0.1``). The port number *can* be changed from
+         ``8090`` to another value.
 
 
          The |api| endpoint provides the ability to check connections

source/includes/facts/upgrade-to-om-4-2-24.rst

@@ -2,8 +2,8 @@ An unintentional and temporary disabling of |tls| occurs when
 upgrading to versions earlier than 4.2.24. Upgrading to 4.2.24
 or later first avoids this outcome.
 
-.. seealso::
+To learn more, see: 
 
-  - :ref:`Ops Manager 4.2.23 release notes <opsmgr-server-4.2.23>`
-  - :ref:`Ops Manager 4.2.24 release notes <opsmgr-server-4.2.24>`
-  - `CVE-2021-20335 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-20335>`__
+- :ref:`Ops Manager 4.2.23 release notes <opsmgr-server-4.2.23>`
+- :ref:`Ops Manager 4.2.24 release notes <opsmgr-server-4.2.24>`
+- `CVE-2021-20335 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-20335>`__

source/includes/head-database-deprecated-encrypt.rst

@@ -1,9 +1,7 @@
-.. note:: 
+|fcv-link| ``4.2`` and later use 
+:manual:`backup cursors </reference/glossary/#std-term-backup-cursor>` instead of
+:opsmgr:`head databases </reference/glossary/#std-term-head-database>`. For
+more information, see :ref:`backup-daemon`.
 
-   FCV |fcv-link| ``4.2`` and later use 
-   :manual:`backup cursors </reference/glossary/#std-term-backup-cursor>` instead of
-   :opsmgr:`head databases </reference/glossary/#std-term-head-database>`. For
-   more information, see :ref:`backup-daemon`.
-
-   For more information on backup encryption for FCV 4.2 or 
-   later, see :ref:`encrypt-snapshots`.
+For more information on backup encryption for FCV 4.2 or 
+later, see :ref:`encrypt-snapshots`.

source/includes/list-tables/api-tutorial-substitution-fields-version-manifest.rst

@@ -23,6 +23,4 @@
      - string
      - Major and minor version of your |onprem| instance.
 
-       .. example::
-
-          ``4.2``
+       For example, ``4.2``. 

source/includes/setting-fileConf-mms.agentCentralUrl.rst

@@ -14,10 +14,10 @@
       address, you must enclose the |ipv6| address in square brackets
       (``[ ]``) to separate it from its port number.
 
-      .. example::
+      For example:
 
-         .. code-block:: ini
+      .. code-block:: ini
    
-            http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
+         http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
    
 

source/includes/setting-fileConf-mms.backupCentralUrl.rst

@@ -14,10 +14,10 @@
       address, you must enclose the |ipv6| address in square brackets
       (``[ ]``) to separate it from its port number.
 
-      .. example::
+      For example:
 
-         .. code-block:: ini
+      .. code-block:: ini
    
-            http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
+         http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
    
 

source/includes/setting-fileConf-mms.centralUrl.rst

@@ -8,23 +8,23 @@
    To use a port other than ``8080``, see
    :doc:`/tutorial/manage-ports`.
 
+   .. code-block:: ini
+   
+      mms.centralUrl=http://mms.example.com:8080
+   
+   
+   Corresponds to :setting:`URL to Access Ops Manager`.
+      
    .. important::
 
       If you plan on accessing your |application| using its |ipv6|
       address, you must enclose the |ipv6| address in square brackets
       (``[ ]``) to separate it from its port number.
 
-      .. example::
-   
-         .. code-block:: ini
+      For example: 
 
-            http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
+      .. code-block:: ini
    
-   .. code-block:: ini
-   
-      mms.centralUrl=http://mms.example.com:8080
-   
-   
-   Corresponds to :setting:`URL to Access Ops Manager`.
+         http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
    
 

source/includes/setting-fileConf-mms.disableCiphers.rst

@@ -53,11 +53,11 @@
       * - :guilabel:`Value`
         - ``<ciphers>``
 
-          .. example::
+          For example:
 
-             .. code-block:: ini
+          .. code-block:: ini
    
-                TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
+             TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
    
    .. warning::
 

source/includes/setting-fileConf-mms.userSvcClass.rst

@@ -21,12 +21,10 @@
       * - Application Database
         - ``UserSvcDb``
 
-          .. important::
-   
-             In |onprem| 6.0, the accepted value is 
-             ``com.xgen.svc.mms.svc.user.UserSvcDb``. 
-             If you use this old accepted value, your |mms|
-             instance will not start during preflight checks.
+          :gold:`IMPORTANT:` In |onprem| 6.0, the accepted value is 
+          ``com.xgen.svc.mms.svc.user.UserSvcDb``. 
+          If you use this old accepted value, your |mms|
+          instance will not start during preflight checks.
 
       * - |ldap|
         - ``UserSvcLdap``

source/includes/setting-uiConf-url-to-access-ops-manager.rst

@@ -8,23 +8,22 @@
    To use a port other than ``8080``, see
    :doc:`/tutorial/manage-ports`.
 
+   .. code-block:: ini
+   
+      http://mms.example.com:8080
+   
+   Corresponds to :setting:`mms.centralUrl`.
+
    .. important::
 
       If you plan on accessing your |application| using its |ipv6|
       address, you must enclose the |ipv6| address in square brackets
       (``[ ]``) to separate it from its port number.
+
+      For example: 
+
+      .. code-block:: ini
    
-      .. example::
-   
-         .. code-block:: ini
-   
-            http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
-   
-   .. code-block:: ini
-   
-      http://mms.example.com:8080
-   
-   
-   Corresponds to :setting:`mms.centralUrl`.
+         http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
    
 

source/includes/steps-add-group.yaml

@@ -22,13 +22,12 @@ content: |
          added to this project. This default type overrides the default
          type set for the parent organization.
 
-         .. include:: /includes/list-table-server-types.rst
-
-         .. note::
+         You can change the server type for individual hosts.
+         
+         You can modify this setting in
+         :doc:`/tutorial/manage-project-settings`.
 
-            - You can modify this setting in
-              :doc:`/tutorial/manage-project-settings`
-            - You can change the server type for individual hosts.
+         .. include:: /includes/list-table-server-types.rst
 
 ---
 title: "Configure |ldap| options."

source/includes/steps-admin-add-s3-blockstore.yaml

@@ -114,9 +114,11 @@ content: |
          the ``<hostname:port>`` format that comprise the blockstore
          metadata database.
 
-         .. example::
+         For example:
 
-            ``h1.ex.com:27017,h2.ex.com:27017,h2.ex.com:27018``
+         .. code-block:: ini
+
+            h1.ex.com:27017,h2.ex.com:27017,h2.ex.com:27018
 
          |mms| displays this field when you set
          :guilabel:`Datastore Type` to :guilabel:`Replica Set` or
@@ -141,16 +143,17 @@ content: |
      * - Username
        - Optional
        - If you set this value:
-
+       
          .. include:: /includes/tabsets/storage-settings-username.rst
 
      * - Password
        - Optional
        - If you set this value:
+       
+         .. include:: /includes/tabsets/storage-settings-password.rst
 
          .. include:: /includes/warning-plaintext-password.rst
 
-         .. include:: /includes/tabsets/storage-settings-password.rst
 
      * - Connection Options
        - Optional

source/includes/steps-admin-add-s3-oplogstore.yaml

@@ -120,18 +120,18 @@ content: |
          the ``<hostname:port>`` format that comprise the blockstore
          metadata database.
 
-         .. example::
+         For example: 
 
-            ``host1.example.com:27017,host2.example.com:27017,host2.example.com:27018``
+         .. code-block:: ini 
+
+            host1.example.com:27017,host2.example.com:27017,host2.example.com:27018
 
          |mms| displays this field when you set
          :guilabel:`Datastore Type` to :guilabel:`Replica Set` or
          :guilabel:`Sharded Cluster`.
 
-         .. important::
-
-            |onprem| uses this metadata store as a sync store. Make
-            sure to provision this store with sufficient storage space.
+         :gold:`IMPORTANT:` |onprem| uses this metadata store as a sync store. Make
+         sure to provision this store with sufficient storage space.
 
      * - MongoDB Hostname
        - Conditional
@@ -140,10 +140,8 @@ content: |
          |mms| displays this field when you set
          :guilabel:`Datastore Type` to :guilabel:`Standalone`.
 
-         .. important::
-
-            |onprem| uses this metadata store as a sync store. Make
-            sure to provision this store with sufficient storage space.
+         :gold:`IMPORTANT:` |onprem| uses this metadata store as a sync store. Make
+         sure to provision this store with sufficient storage space.
 
      * - MongoDB Port
        - Conditional
@@ -163,9 +161,9 @@ content: |
        - Optional
        - If you set this value:
 
-         .. include:: /includes/warning-plaintext-password.rst
-
          .. include:: /includes/tabsets/storage-settings-password.rst
+         
+         .. include:: /includes/warning-plaintext-password.rst
 
      * - Connection Options
        - Optional