DOCSP-23190 BACKPORT (#1257)

Author: Dave Cuthbert

source/tutorial/model-monetary-data.txt

@@ -77,26 +77,32 @@ Numeric Model
 Using the Decimal BSON Type
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``decimal`` :doc:`BSON type </reference/bson-types>` uses the
-IEEE 754 decimal128 decimal-based floating-point numbering format.
-Unlike binary-based floating-point formats (i.e., the ``double`` BSON
-type), decimal128 does not approximate decimal values and is able to
+The ``decimal128`` :ref:`BSON type <bson-types>` uses the IEEE 754
+``decimal128`` decimal-based floating-point numbering format. Unlike
+binary-based floating-point formats such as the ``double`` BSON type,
+``decimal128`` does not approximate decimal values and is able to
 provide the exact precision required for working with monetary data.
 
-From :binary:`~bin.mongosh` ``decimal`` values are assigned and
-queried using the ``NumberDecimal()`` constructor.  The following
-example adds a document containing gas prices to a ``gasprices``
-collection:
+In :binary:`~bin.mongosh`, ``decimal`` values are assigned and queried
+using the ``Decimal128()`` constructor.  The following example adds a
+document containing gas prices to a ``gasprices`` collection:
 
 .. code-block:: javascript
 
-   db.gasprices.insert{ "_id" : 1, "date" : ISODate(), "price" : NumberDecimal("2.099"), "station" : "Quikstop", "grade" : "regular" }
-   
+   db.gasprices.insertOne(
+      {
+         "date" : ISODate(), 
+         "price" : Decimal128("2.099"), 
+         "station" : "Quikstop", 
+         "grade" : "regular" 
+      }
+   )
+
 The following query matches the document above:
 
 .. code-block:: javascript
 
-   db.gasprices.find( { price: NumberDecimal("2.099") } )
+   db.gasprices.find( { price: Decimal128("2.099") } )
 
 For more information on the ``decimal`` type, see
 :ref:`shell-type-decimal`.
@@ -112,7 +118,7 @@ to perform the transformation as it accesses records.
 
    Alternative to the procedure outlined below, starting in version
    4.0, you can use the :expression:`$convert` and its helper
-   :expression:`$toDecimal` operator to convert values to ``NumberDecimal()``.
+   :expression:`$toDecimal` operator to convert values to ``Decimal128()``.
 
 One-Time Collection Transformation
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^