DOCSP-15327 final round NextGen cleanup

Author: andf-mongodb

source/about.txt

@@ -27,7 +27,7 @@ Attribution-NonCommercial-ShareAlike 3.0 United States License
 |copy| MongoDB, Inc. 2008-|year|
 
 Man Pages
---------
+---------
 
 In addition to the `MongoDB Manual <https://docs.mongodb.com/manual/#>`_, you can
 access the :manual:`MongoDB Man Pages </manpages.tar.gz>`, 

source/administration/security-checklist.txt

@@ -26,15 +26,17 @@ Pre-production Checklist/Considerations
   requires that all clients and servers provide valid credentials
   before they can connect to the system.
 
-See also:
+  |
 
-- :doc:`/core/authentication`
-- :doc:`/tutorial/enable-authentication`
+  See also:
+
+  - :doc:`/core/authentication`
+  - :doc:`/tutorial/enable-authentication`
 
 .. _security-checklist-role-based-access-control:
 
-Configure Role-Based Access Control
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+|arrow| Configure Role-Based Access Control
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - Create a user administrator **first**, then create additional
   users. Create a unique MongoDB user for each person/application
@@ -45,16 +47,19 @@ Configure Role-Based Access Control
   users and assign them only the roles they need to perform their
   operations. A user can be a person or a client application.
 
-  Note that a user can have privileges across different databases. If a
-  user requires privileges on multiple databases, create a
-  single user with roles that grant applicable database
-  privileges instead of creating the user multiple times in
-  different databases.
+  .. note::
+  
+     A user can have privileges across different databases. If a user
+     requires privileges on multiple databases, create a single user
+     with roles that grant applicable database privileges instead of
+     creating the user multiple times in different databases.
+
+  |
 
-See also:
+  See also:
 
-- :doc:`/core/authorization`
-- :doc:`/tutorial/manage-users-and-roles`
+  - :doc:`/core/authorization`
+  - :doc:`/tutorial/manage-users-and-roles`
 
 |arrow| Encrypt Communication (TLS/SSL)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -71,7 +76,9 @@ See also:
 
      .. include:: /includes/fact-tls-1.0.rst
 
-See also: :doc:`/tutorial/configure-ssl`.
+  |
+
+  See also: :doc:`/tutorial/configure-ssl`.
 
 .. |binary| replace:: MongoDB
 
@@ -108,19 +115,21 @@ See also: :doc:`/tutorial/configure-ssl`.
 
      .. include:: /includes/fact-default-bind-ip-change.rst
 
-See also:
+  |
 
-- :doc:`/core/security-hardening` 
+  See also:
 
-- the :setting:`net.bindIp` configuration setting
-   
-- the :setting:`security.clusterIpSourceWhitelist` configuration
-  setting
+  - :doc:`/core/security-hardening` 
 
-- the :ref:`authenticationRestrictions
-  <db-createUser-authenticationRestrictions>` field to the
-  :dbcommand:`db.createUser()` command to specify a per-user IP
-  whitelist.
+  - the :setting:`net.bindIp` configuration setting
+     
+  - the :setting:`security.clusterIpSourceWhitelist` configuration
+    setting
+
+  - the :ref:`authenticationRestrictions
+    <db-createUser-authenticationRestrictions>` field to the
+    :method:`db.createUser()` command to specify a per-user IP
+    whitelist.
 
 
 |arrow| Audit System Activity
@@ -136,11 +145,13 @@ See also:
   up filters to record specific events, such as authentication
   events.
 
-See also:
+  |
+
+  See also:
 
-- :doc:`/core/auditing`
+  - :doc:`/core/auditing`
 
-- :doc:`/tutorial/configure-auditing`
+  - :doc:`/tutorial/configure-auditing`
 
 |arrow| Run MongoDB with a Dedicated User
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -149,7 +160,9 @@ See also:
   account. Ensure that the account has permissions to access data
   but no unnecessary permissions.
 
-See also: :doc:`/installation`
+  |
+
+  See also: :doc:`/installation`
 
 .. _security-checklist-javascript:
 
@@ -168,7 +181,9 @@ See also: :doc:`/installation`
   This ensures that all documents stored by the
   :binary:`~bin.mongod` instance are valid :term:`BSON`.
 
-See also: :doc:`/core/security-hardening`
+  |
+
+  See also: :doc:`/core/security-hardening`
 
 |arrow| Request a Security Technical Implementation Guide (where applicable)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/changeStreams.txt

@@ -118,6 +118,15 @@ The following example opens a change stream for a collection and
 iterates over the cursor to retrieve the change stream documents.
 [#start-time]_
 
+----------
+
+.. |arrow| unicode:: U+27A4
+
+|arrow| Use the **Select your language** drop-down menu in the
+upper-right to set the language of the examples on this page.
+
+----------
+
 .. tabs-selector:: drivers
 
 .. tabs-drivers::
@@ -308,6 +317,13 @@ open, the cursor remains open until one of the following occurs:
 Modify Change Stream Output
 ---------------------------
 
+----------
+
+|arrow| Use the **Select your language** drop-down menu in the
+upper-right to set the language of the examples on this page.
+
+----------
+
 .. tabs-drivers::
 
    .. tab:: 
@@ -482,6 +498,13 @@ the update operation. However, you can configure the change stream
 to return the most current majority-committed version of the updated
 document.
 
+----------
+
+|arrow| Use the **Select your language** drop-down menu in the
+upper-right to set the language of the examples on this page.
+
+----------
+
 .. tabs-drivers::
 
    .. tab::

source/core/capped-collections.txt

@@ -116,8 +116,8 @@ Query Efficiency
 ~~~~~~~~~~~~~~~~
 
 Use natural ordering to retrieve the most recently inserted elements
-from the collection efficiently. This is (somewhat) analogous to tail
-on a log file.
+from the collection efficiently. This is similar to using the ``tail``
+command on a log file.
 
 Aggregation ``$out``
 ~~~~~~~~~~~~~~~~~~~~
@@ -166,7 +166,9 @@ collection using the ``max`` field as in the following document:
    documents if a collection reaches the maximum size limit before it
    reaches the maximum document count.
 
-.. see:: :method:`db.createCollection()` and  :dbcommand:`create`.
+.. see::
+
+   :method:`db.createCollection()` and  :dbcommand:`create`.
 
 .. _capped-collections-options:
 

source/core/map-reduce-concurrency.txt

@@ -10,8 +10,7 @@ Map-Reduce Concurrency
    :depth: 1
    :class: singlecol
 
-.. admonition:: Aggregation Pipeline as an Alternative to Map-Reduce
-   :class: note
+.. note:: Aggregation Pipeline as an Alternative to Map-Reduce
 
    .. include:: /includes/fact-use-aggregation-not-map-reduce.rst
 

source/core/map-reduce-sharded-collections.txt

@@ -10,8 +10,7 @@ Map-Reduce and Sharded Collections
    :depth: 1
    :class: singlecol
 
-.. admonition:: Aggregation Pipeline as an Alternative to Map-Reduce
-   :class: note
+.. note:: Aggregation Pipeline as an Alternative to Map-Reduce
 
    .. include:: /includes/fact-use-aggregation-not-map-reduce.rst
 

source/core/read-isolation-consistency-recency.txt

@@ -279,7 +279,7 @@ upper-right to set the language of this example.
 
 ----------
 
-.. tabs-pillstrip:: languages
+.. tabs-selector:: drivers
 
 .. tabs-drivers::
 

source/core/replica-set-high-availability.txt

@@ -1,4 +1,3 @@
-: replica set; failover
 .. _replica-set-failover-administration:
 .. _replica-set-failover:
 .. _failover:

source/core/replica-set-rollbacks.txt

@@ -1,7 +1,3 @@
-
-   single: replica set; rollbacks
-   single: consistency; rollbacks
-
 .. _replica-set-rollbacks:
 .. _replica-set-rollback:
 
@@ -58,7 +54,6 @@ By default, when a rollback occurs, MongoDB writes the rollback data to
 :term:`BSON` files.
 
 .. note:: Rollback Directory Change
-
 
    Starting in Mongo 4.4, the rollback directory for a collection is named
    after the collection's UUID rather than the collection namespace.

source/core/security-client-side-encryption.txt

@@ -413,7 +413,7 @@ the following official 4.2-compatible driver versions:
      - Supported Versions
      - Quickstarts / Tutorials
 
-   * - :driverecosystem:`Node </node>` 
+   * - :driver:`Node </node>` 
      - ``3.4.0+``
      - | `Node.js Quickstart <https://mongodb.github.io/node-mongodb-native/3.4/reference/client-side-encryption/>`__
        | :driver:`Client-Side Field Level Encryption Guide </security/client-side-field-level-encryption-guide>`