DOCSP-44585-double-type (#362)

* DOCSP-44585-double-type

* *

* external review

Author: ajhuh-mdb

source/reference/data-types.txt

@@ -60,17 +60,34 @@ Starting in  1.8.0, the ``ObjectId`` wrapper no longer accepts:
 
    :method:`ObjectId` 
 
+Double 
+------
+
+The :node-api:`Double() <Double.html>` constructor can be used to
+explicitly specify a double:
+
+.. code-block:: javascript
+
+      db.types.insertOne(
+         {
+            "_id": 2,
+            "value": Double(1),
+            "expectedType": "Double" 
+         }
+      )
+
+.. note:: 
+
+   If field's value is a number that can be converted to a 32-bit integer, 
+   ``mongosh`` will store it as ``Int32``. If not, ``mongosh`` defaults to 
+   storing the number as a ``Double``. To specify the value type, use the 
+   ``Double()`` or ``Int32()`` constructors. 
+
 .. _shell-type-int:
 
 Int32
 -----
 
-If a number can be converted to a 32-bit integer, ``mongosh`` will
-store it as ``Int32``. If not, ``mongosh`` defaults to storing the
-number as a ``Double``. Numerical values that are stored as ``Int32``
-in ``mongosh`` would have been stored by default as ``Double`` in the
-``mongo`` shell.
-
 The :node-api:`Int32() <Int32.html>` constructor can be used to
 explicitly specify 32-bit integers.
 
@@ -79,7 +96,7 @@ explicitly specify 32-bit integers.
       db.types.insertOne(
          {
              "_id": 1,
-             "value": Int32("1"),
+             "value": Int32(1),
              "expectedType": "Int32" 
          }
       )
@@ -103,7 +120,7 @@ explicitly specify a 64-bit integer.
       db.types.insertOne(
          {
             "_id": 3,
-            "value": Long("1"),
+            "value": Long(1),
             "expectedType": "Long" 
          }
       )