DOCPS-26298 updates BSON-related doc directives (#2105)

* DOCPS-26298 updates BSON-related doc directives

* internal review feedback

* internal review feedback

Author: jmd-mongo

source/core/map-reduce.txt

@@ -60,13 +60,12 @@ map and reduce operation, such as perform additional calculations.
 .. note::
 
    Starting in MongoDB 4.4, :dbcommand:`mapReduce` no longer supports
-   the deprecated BSON type JavaScript code with scope
-   (:doc:`BSON type 15 </reference/bson-types/>`) for its functions. The
-   ``map``, ``reduce``, and ``finalize`` functions must be either BSON
-   type String (:doc:`BSON type 2 </reference/bson-types/>`) or
-   BSON type JavaScript (:doc:`BSON type 13 </reference/bson-types/>`).
-   To pass constant values which will be accessible in the ``map``,
-   ``reduce``, and ``finalize`` functions, use the ``scope`` parameter.
+   the deprecated :ref:`BSON type <bson-types>` JavaScript code with 
+   scope (BSON Type 15) for its functions. The ``map``, ``reduce``, 
+   and ``finalize`` functions must be either BSON type String 
+   (BSON Type 2) or BSON type JavaScript (BSON Type 13). To pass 
+   constant values which will be accessible in the ``map``, ``reduce``, 
+   and ``finalize`` functions, use the ``scope`` parameter.
 
    The use of JavaScript code with scope for the :dbcommand:`mapReduce`
    functions has been deprecated since version 4.2.1.

source/includes/extracts-agg-operators.yaml

@@ -937,7 +937,7 @@ content: |
           <Int64>`.  
 
           Returns boolean ``false`` if the expression resolves to any
-          other :doc:`BSON type </reference/mongodb-extended-json>`,
+          other :ref:`BSON type <bson-types>`,
           ``null``, or a missing field.
 
           .. versionadded:: 4.4

source/includes/parameters-map-reduce.rst

@@ -33,11 +33,10 @@ The ``map`` function has the following requirements:
   starting in version 4.4.
 
 - Starting in MongoDB 4.4, :dbcommand:`mapReduce` no longer supports
-  the deprecated BSON type JavaScript code with scope
-  (:doc:`BSON type 15 </reference/bson-types/>`) for its functions. The
-  ``map`` function must be either BSON type String (:doc:`BSON type 2
-  </reference/bson-types/>`) or BSON type JavaScript (:doc:`BSON type 13
-  </reference/bson-types/>`). To pass constant values which will be
+  the deprecated :ref:`BSON Type <bson-types>` JavaScript code with 
+  scope (BSON Type 15) for its functions. The ``map`` function must be 
+  either BSON Type String (BSON Type 2) or BSON Type JavaScript 
+  (BSON Type 13). To pass constant values which will be
   accessible in the ``map`` function, use the ``scope`` parameter.
 
   | The use of JavaScript code with scope for the ``map`` function has
@@ -102,12 +101,11 @@ The ``reduce`` function exhibits the following behaviors:
   joined together in subsequent ``reduce`` steps.
 
 - Starting in MongoDB 4.4, :dbcommand:`mapReduce` no longer supports
-  the deprecated BSON type JavaScript code with scope
-  (:doc:`BSON type 15 </reference/bson-types/>`) for its functions. The
-  ``reduce`` function must be either BSON type String (:doc:`BSON type 2
-  </reference/bson-types/>`) or BSON type JavaScript (:doc:`BSON type 13
-  </reference/bson-types/>`). To pass constant values which will be
-  accessible in the ``reduce`` function, use the ``scope`` parameter.
+  the deprecated BSON Type JavaScript code with scope (BSON Type 15) 
+  for its functions. The ``reduce`` function must be either BSON Type 
+  String (BSON Type 2) or BSON Type JavaScript (BSON Type 13). To pass 
+  constant values which will be accessible in the ``reduce`` function, 
+  use the ``scope`` parameter.
 
   | The use of JavaScript code with scope for the ``reduce`` function
     has been deprecated since version 4.2.1.
@@ -286,13 +284,11 @@ aware that:
   the ``scope`` parameter.
 
 - Starting in MongoDB 4.4, :dbcommand:`mapReduce` no longer supports
-  the deprecated BSON type JavaScript code with scope
-  (:doc:`BSON type 15 </reference/bson-types/>`) for its functions. The
-  ``finalize`` function must be either BSON type String
-  (:doc:`BSON type 2 </reference/bson-types/>`) or BSON type JavaScript
-  (:doc:`BSON type 13 </reference/bson-types/>`). To pass constant
-  values which will be accessible in the ``finalize`` function, use the
-  ``scope`` parameter.
+  the deprecated BSON Type JavaScript code with scope (BSON Type 15) for 
+  its functions. The ``finalize`` function must be either BSON Type 
+  String (BSON Type 2) or BSON Type JavaScript (BSON Type 13). To pass 
+  constant values which will be accessible in the ``finalize`` function, 
+  use the ``scope`` parameter.
 
   | The use of JavaScript code with scope for the ``finalize`` function
     has been deprecated since version 4.2.1.

source/reference/aggregation-variables.txt

@@ -13,7 +13,7 @@ Variables in Aggregation Expressions
 :ref:`Aggregation expressions <aggregation-expressions>` can use both
 user-defined and system variables.
 
-Variables can hold any :doc:`BSON type data </reference/bson-types>`.
+Variables can hold any :ref:`BSON type data <bson-types>`.
 To access the value of the variable, prefix the variable name with
 double dollar signs (``$$``); i.e. ``"$$<variable>"``.
 

source/reference/command/mapReduce.txt

@@ -86,9 +86,8 @@ The command takes the following fields as arguments:
 
        A JavaScript function that associates or "maps" a ``value``
        with a ``key`` and emits the ``key`` and value ``pair``. You
-       can specify the function as BSON type JavaScript (i.e.
-       :doc:`BSON type 13 </reference/bson-types/>`) or String (i.e.
-       :doc:`BSON type 2 </reference/bson-types/>`).
+       can specify the function as :ref:`BSON type <bson-types>` 
+       Javascript (BSON Type 13) or String (BSON Type 2).
 
        For more information, see :ref:`Requirements for the map Function
        <mapreduce-map-cmd>`.
@@ -99,9 +98,8 @@ The command takes the following fields as arguments:
 
        A JavaScript function that "reduces" to a single object all
        the ``values`` associated with a particular ``key``. You can
-       specify the function as BSON type JavaScript (i.e.
-       :doc:`BSON type 13 </reference/bson-types/>`) or String (i.e.
-       :doc:`BSON type 2 </reference/bson-types/>`).
+       specify the function as BSON type JavaScript (BSON Type 13) or 
+       String (BSON Type 2).
 
        For more information, see :ref:`Requirements for the reduce
        Function <mapreduce-reduce-cmd>`.
@@ -148,9 +146,7 @@ The command takes the following fields as arguments:
 
        Optional. A JavaScript function that modifies the output after
        the ``reduce`` function. You can specify the function as
-       BSON type JavaScript (i.e.
-       :doc:`BSON type 13 </reference/bson-types/>`) or String (i.e.
-       :doc:`BSON type 2 </reference/bson-types/>`).
+       BSON type JavaScript (BSON Type 13) or String (BSON Type 2).
 
        For more information, see :ref:`Requirements for the finalize
        Function <mapreduce-finalize-cmd>`.

source/reference/method/db.collection.mapReduce.txt

@@ -74,9 +74,8 @@ Syntax
 
      - A JavaScript function that associates or "maps" a ``value`` with
        a ``key`` and emits the ``key`` and value ``pair``. You can
-       specify the function as BSON type JavaScript (i.e. :doc:`BSON
-       type 13 </reference/bson-types/>`) or String (i.e. :doc:`BSON
-       type 2 </reference/bson-types/>`).
+       specify the function as :ref:`BSON type <bson-types>` JavaScript 
+       (BSON Type 13) or String (BSON Type 2).
 
        See :ref:`mapreduce-map-mtd` for more information.
 
@@ -88,9 +87,8 @@ Syntax
 
      - A JavaScript function that "reduces" to a single object all the
        ``values`` associated with a particular ``key``. You can specify
-       the function as BSON type JavaScript (i.e. :doc:`BSON type 13
-       </reference/bson-types/>`) or String (i.e. :doc:`BSON type 2
-       </reference/bson-types/>`).
+       the function as BSON type JavaScript (BSON Type 13) or String 
+       (BSON Type 2).
 
        See :ref:`mapreduce-reduce-mtd` for more information.
 
@@ -172,8 +170,7 @@ The following table describes additional arguments that
 
      - Optional. A JavaScript function that modifies the output after
        the ``reduce`` function. You can specify the function as BSON type
-       JavaScript (i.e. :doc:`BSON type 13 </reference/bson-types/>`)
-       or String (i.e. :doc:`BSON type 2 </reference/bson-types/>`).
+       JavaScript (BSON Type 13) or String (BSON Type 2).
 
        See :ref:`mapreduce-finalize-mtd` for more information.
 

source/reference/operator/aggregation/bucket.txt

@@ -181,7 +181,7 @@ or the operation throws an error:
 - A :ref:`default <bucket-default>` value is specified to bucket
   documents whose ``groupBy``
   values are outside of the ``boundaries`` or of a different
-  :doc:`BSON type </reference/bson-types>` than the values in
+  :ref:`BSON type <bson-types>` than the values in
   ``boundaries``.
 
 If the ``groupBy`` expression resolves to an array or a document,

source/reference/operator/aggregation/isNumber.txt

@@ -31,7 +31,7 @@ Definition
    - ``true`` if the expression resolves to a number.
 
    - ``false`` if the expression resolves to any other
-     :doc:`BSON type </reference/mongodb-extended-json>`, ``null``, or
+     :ref:`BSON type <bson-types>`, ``null``, or
      a missing field.
 
    :expression:`$isNumber` has the following 

source/reference/operator/aggregation/type.txt

@@ -15,8 +15,8 @@ Definition
 
 .. expression:: $type
 
-   Returns a string that specifies the :doc:`BSON type
-   </reference/bson-types/>` of the argument.
+   Returns a string that specifies the :ref:`BSON type
+   <bson-types>` of the argument.
 
    :expression:`$type` has the following :ref:`operator expression
    syntax <agg-quick-ref-operator-expressions>`:

source/reference/operator/query/where.txt

@@ -30,11 +30,10 @@ Definition
 .. note::
 
    Starting in MongoDB 4.4, :query:`$where` no longer supports the
-   deprecated BSON type JavaScript code with scope (:ref:`BSON type 15
-   <bson-types>`). The :query:`$where` operator only
-   supports BSON type String (:ref:`BSON type 2 <bson-types>`) or 
-   BSON type JavaScript (:ref:`BSON type 13 <bson-types>`). The use of 
-   BSON type JavaScript with scope for :query:`$where` has been 
+   deprecated :ref:`BSON type <bson-types>` JavaScript code with scope 
+   (BSON Type 15). The :query:`$where` operator only supports BSON type 
+   String (BSON Type 2) or BSON type JavaScript (BSON Type 13). The use 
+   of BSON type JavaScript with scope for :query:`$where` has been 
    deprecated since MongoDB 4.2.1.
 
 .. note:: Aggregation Alternatives Preferred

source/release-notes/4.4-compatibility.txt

@@ -246,14 +246,13 @@ In earlier versions, a single emit can only hold half of MongoDB's
 Remove support for BSON Type JavaScript code with scope
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:dbcommand:`mapReduce` no longer supports the deprecated BSON type
-JavaScript code with scope (:doc:`BSON type 15
-</reference/bson-types/>`) for its functions. The ``map``,
-``reduce``, and ``finalize`` functions must be either BSON type
-String (:doc:`BSON type 2 </reference/bson-types/>`) or BSON type
-JavaScript (:doc:`BSON type 13 </reference/bson-types/>`). To pass
-constant values which will be accessible in the ``map``, ``reduce``,
-and ``finalize`` functions, use the ``scope`` parameter.
+:dbcommand:`mapReduce` no longer supports the deprecated :ref:`BSON 
+type <bson-types>` JavaScript code with scope (BSON type 15) for its 
+functions. The ``map``, ``reduce``, and ``finalize`` functions must be 
+either BSON type String (BSON Type 2) or BSON type JavaScript 
+(BSON Type 13). To pass constant values which will be accessible in 
+the ``map``, ``reduce``, and ``finalize`` functions, use the ``scope`` 
+parameter.
 
 The use of JavaScript code with scope for the :dbcommand:`mapReduce`
 functions has been deprecated since version 4.2.1.
@@ -432,20 +431,16 @@ BSON Type JavaScript code with scope
 Starting in MongoDB 4.4:
 
 - :query:`$where` no longer supports the deprecated BSON type
-  JavaScript code with scope (:doc:`BSON type 15
-  </reference/bson-types/>`). The :query:`$where` operator only
-  supports BSON type String (:doc:`BSON type 2
-  </reference/bson-types/>`) or BSON type JavaScript (:doc:`BSON
-  type 13 </reference/bson-types/>`).
+  JavaScript code with scope (BSON Type 15). The :query:`$where` 
+  operator only supports BSON type String (BSON Type 2) or BSON type 
+  JavaScript (BSON Type 13).
 
 - :dbcommand:`mapReduce` no longer supports the deprecated BSON type
-  JavaScript code with scope (:doc:`BSON type 15
-  </reference/bson-types/>`) for its functions. The ``map``,
-  ``reduce``, and ``finalize`` functions must be BSON type String
-  (:doc:`BSON type 2 </reference/bson-types/>`) or BSON type JavaScript
-  (:doc:`BSON type 13 </reference/bson-types/>`). To pass constant
-  values which will be accessible in the ``map``, ``reduce``, and
-  ``finalize`` functions, use the ``scope`` parameter.
+  JavaScript code with scope (BSON Type 15) for its functions. The 
+  ``map``, ``reduce``, and ``finalize`` functions must be BSON type
+  String (BSON Type 2) or BSON type JavaScript (BSON Type 13). To pass 
+  constant values which will be accessible in the ``map``, ``reduce``, 
+  and ``finalize`` functions, use the ``scope`` parameter.
 
 The use of BSON type JavaScript code with scope for :query:`$where` and
 the :dbcommand:`mapReduce` functions has been deprecated since MongoDB

source/release-notes/4.4.txt

@@ -526,7 +526,7 @@ New Aggregation Operators
        <Int64>`.  
 
        Returns boolean ``false`` if the expression resolves to any other
-       :doc:`BSON type </reference/mongodb-extended-json>`, ``null``, or
+       :ref:`BSON type <bson-types>`, ``null``, or
        a missing field
 
    * - :expression:`$replaceOne`

source/tutorial/backup-and-restore-tools.txt

@@ -40,7 +40,7 @@ Deployments
 ~~~~~~~~~~~
 
 The :binary:`~bin.mongodump` and :binary:`~bin.mongorestore` utilities
-work with :doc:`BSON </reference/bson-types>` data dumps, and are
+work with :ref:`BSON <bson-types>` data dumps, and are
 useful for creating backups of small deployments. For resilient and
 non-disruptive backups, use a file system or block-level disk snapshot
 function, such as the methods described in the :doc:`/core/backups`
@@ -61,10 +61,10 @@ Binary BSON Dumps
 -----------------
 
 The :binary:`~bin.mongorestore` and :binary:`~bin.mongodump` utilities work with
-:doc:`BSON </reference/bson-types>` data dumps, and are useful for creating
-backups of small deployments. For resilient and non-disruptive backups, use a
-file system or block-level disk snapshot function, such as the methods
-described in the :doc:`/core/backups` document.
+BSON data dumps, and are useful for creating backups of small deployments. 
+For resilient and non-disruptive backups, use a file system or 
+block-level disk snapshot function, such as the methods described in the 
+:doc:`/core/backups` document.
 
 Use these tools for backups if other backup methods, such as
 |mms-home| or