DOCS-948 incorporate Kristina's feedback

Author: kay-kim

source/core/shell-types.txt

@@ -141,10 +141,11 @@ the following operation in the :program:`mongo` shell:
 NumberLong
 ----------
 
-The :program:`mongo` shell provides the ``NumberLong()`` class to handle
-numbers of type long.
+By default, the :program:`mongo` shell treats all numbers as
+floating-point values. The :program:`mongo` shell provides the
+``NumberLong()`` class to handle numbers of 64-bit integers.
 
-The ``NumberLong()`` accepts the long as a string:
+The ``NumberLong()`` constructor accepts the long as a string:
 
 .. code-block:: javascript
 
@@ -159,21 +160,26 @@ collection:
    db.collection.update( { _id: 10 },
                          { $set:  { calc: NumberLong("209084588685266550") } } )
 
-.. wiki content -- I don't think the following applies anymore
-
-   Numbers
-   By default, the shell treats all numbers as floating-point values.
-   You have the option to work with 64-bit integers by using a class
-   built into the shell called NumberLong() If you have long/integer
-   BSON data from the database you may see something like this:
-   {"count" : NumberLong("575175")}
-   Setting/incrementing any number from javascript will (most likely)
-   change the data type to a floating point value.
-   Here is an example of creating a document with a long field:
-   doc = { field: new NumberLong("123212313")}
-   Note that prior to 1.6 long numbers might be displayed like this:
-   "bytes" : {
-      "floatApprox" : 5284376243087482000,
-      "top" : 1230364721,
-      "bottom" : 4240317554
-   }
+If you :operator:`increment <$inc>` the field that contains a
+``NumberLong`` object, the data type changes to a floating point value,
+as in the following example:
+
+#. :operator:`Increment <$inc>` the ``calc`` field:
+
+   .. code-block:: javascript
+
+      db.collection.update( { _id: 10 },
+                            { $inc: { calc: 5 } } )
+
+#. Select the updated document:
+
+   .. code-block:: javascript
+
+      db.collection.findOne( { _id: 10 } )
+
+   In the updated document, the ``calc`` field contains a floating
+   point value:
+
+   .. code-block:: sh
+
+      { "_id" : 10, "calc" : 209084588685266560 }