DOCS-689 incorporate feedback from mike and ed

Author: kay-kim

source/core/object-id.txt

@@ -39,9 +39,9 @@ information on MongoDB's document orientation.
 ObjectId()
 ----------
 
-The :program:`mongo` shell provides the ``ObjectId()`` wrapper class
-to generate can generate a new ObjectId, and to provide the following
-helper attribute and methods:
+The :program:`mongo` shell provides the ``ObjectId()`` wrapper class to
+generate a new ObjectId, and to provide the following helper attribute
+and methods:
 
 - ``str``
 

source/core/read-operations.txt

@@ -702,7 +702,7 @@ variable:
          print(tojson(myItem));
      }
 
-  As an alternative print operation, consider the the ``printjson()``
+  As an alternative print operation, consider the ``printjson()``
   helper method to replace ``print(tojson())``:
 
   .. code-block:: javascript

source/mongo.txt

@@ -4,9 +4,9 @@ Using the ``mongo`` Shell
 
 .. default-domain:: mongodb
 
-:program:`mongo` shell is the MongoDB interactive shell and is part of
+The :program:`mongo` shell is the MongoDB interactive shell and is part of
 the `MongoDB distribution <http://www.mongodb.org/downloads>`_. The
-:program:`mongo` is located in the ``<mongodb installation dir>/bin``
+:program:`mongo` program is located in the ``<mongodb installation dir>/bin``
 directory.
 
 The :program:`mongo` shell is a JavaScript shell [#spider-monkey]_ from
@@ -62,9 +62,9 @@ To start the :program:`mongo` shell and connect to your :doc:`MongoDB
 
       use myDatabase
 
-   See :ref:`mongo-shell-help-db` to list the available databases. See also
-   :ref:`mongo-shell-getSiblingDB` to access a different
-   database from the current database.
+   To list the available database, use the command ``show dbs``. See
+   also :ref:`mongo-shell-getSiblingDB` to access a different database
+   from the current database.
 
 To start the :program:`mongo` shell with other options, see
 :ref:`examples of starting up mongo <mongo-usage-examples>` and
@@ -103,12 +103,14 @@ From the :program:`mongo` shell, you can use the :doc:`shell methods
 
   If the :program:`mongo` shell does not accept the name of the
   collection, for instance if the name contains a space or starts with
-  a number, use an alternate syntax to refer to the collection, as in
-  the following:
+  a number, you can use an alternate syntax to refer to the
+  collection, as in the following alternates:
 
   .. code-block:: javascript
 
-     db['3test'].find()
+     db["3test"].find()
+
+     db.getCollection("3test").find()
 
 - The :method:`find() <db.collection.find()>` method is the JavaScript
   method to retrieve documents from ``myCollection``. The
@@ -119,9 +121,9 @@ From the :program:`mongo` shell, you can use the :doc:`shell methods
   first 20 documents that match the query. The :program:`mongo` shell
   will prompt ``Type it`` to iterate another 20 times.
 
-  You can use the ``DBQuery.shellBatchSize`` to change the number of
-  iteration from the default value ``20``, as in the following example
-  which sets it to ``10``:
+  You can use the ``DBQuery.shellBatchSize`` variable to change the
+  number of iteration from the default value ``20``, as in the
+  following example which sets it to ``10``:
 
   .. code-block:: javascript
 
@@ -158,8 +160,8 @@ Print
 
 The :program:`mongo` shell automatically prints the results of the
 :method:`find() <db.collection.find()>` method if the returned cursor
-is not assigned to a variable. To format the result as :term:`JSON`, you can
-add the ``.pretty()`` to the operation, as in the following:
+is not assigned to a variable. To format the result, you can add the
+``.pretty()`` to the operation, as in the following:
 
 .. code-block:: javascript
 
@@ -426,6 +428,22 @@ JavaScript methods to handle the cursor returned from the
 
      db.collection.find().toArray
 
+Some useful methods for handling cursors are:
+
+- :method:`hasNext() <cursor.hasNext()>` which checks whether the
+  cursor has more documents to return.
+
+- :method:`next() <cursor.next()>` which returns the next document and
+  moves by one the position of the cursor.
+
+- :method:`forEach(\<function\>) <cursor.forEach()>` which iterates the
+  whole cursor and applies the ``<function>`` to each document returned
+  by the cursor.
+
+For examples on iterating a cursor and retrieving the documents from
+the cursor, see :ref:`cursor handling <read-operations-cursors>`. See
+also :ref:`js-query-cursor-methods` for all available cursor methods.
+
 .. _mongo-shell-tips:
 
 Tips
@@ -615,7 +633,7 @@ instantiate database connections using the ``Mongo()`` constructor:
    new Mongo(<host:port>)
 
 Consider the following example that instantiates a new connection to
-the MongoDB instance running on localhost on the default port and set
+the MongoDB instance running on localhost on the default port and sets
 the current ``db`` to ``myDatabase``:
 
 .. code-block:: javascript

source/reference/mongo-shell-reference.txt

@@ -100,7 +100,7 @@ Basic Shell Javascript Operations
 ----------------------------------
 
 The :program:`mongo` shell provides numerous
-:doc:`/reference/javascript` for database operations.
+:doc:`/reference/javascript` methods for database operations.
 
 In the :program:`mongo` shell, ``db`` is the variable that references
 the current database. The variable is automatically set to the default
@@ -299,21 +299,21 @@ The following table provides some common read operations in the
    * - :method:`db.collection.find( \<query\> ).count() <cursor.count()>`
 
      - Returns the total number of objects that match the query. 
-     
+
        The :method:`<cursor.count()>` ignores :method:`limit()
        <cursor.limit()>` and :method:`skip() <cursor.skip()>`. For
        example, if 100 records match but the limit is 10,
        :method:`count() <cursor.count()>` will return 100. This will be
        faster than iterating yourself, but still take time.
 
    * - :method:`db.collection.findOne( \<query\> ) <db.collection.findOne()>`
-   
+
      - Find and return a single object. Returns null if not found. 
-     
-        The following example selects a single documents in the
+
+        The following example selects a single document in the
         ``users`` collection with the ``name`` field matches to
         ``"Joe"``:
-     
+
        .. code-block:: javascript
 
           coll = db.users;
@@ -439,7 +439,7 @@ opening new connections from the :program:`mongo` shell.
 Miscellaneous
 -------------
 
-The following table displays some miscellaneous method:
+The following table displays some miscellaneous methods:
 
 .. list-table::
    :header-rows: 1