DOCS-799 edits

Author: Sam Kleinman

source/core/read-operations.txt

@@ -34,7 +34,7 @@ In the :program:`mongo` shell, the :method:`find()
 <db.collection.find()>` and :method:`findOne()
 <db.collection.findOne()>` methods perform read operations. The
 :method:`find() <db.collection.find()>` method has the following
-syntax [#formal-query-structure]_:
+syntax: [#formal-query-structure]_
 
 .. code-block:: javascript
 

source/reference/meta-query-operators.txt

@@ -11,10 +11,10 @@ Introduction
 
 In addition to the :doc:`MongoDB Query Operators
 </reference/operators>`, there are a number of "meta" operators that
-you may use to modify the output or behavior of a query. On the server,
+you can modify the output or behavior of a query. On the server,
 MongoDB treats the query and the options as a single object. The
-:program:`mongo` shell may provide :ref:`cursor methods
-<js-query-cursor-methods>` for these options. When possible, use these
+:program:`mongo` shell and driver interfaces may provide :ref:`cursor methods
+<js-query-cursor-methods>` that wrap these options. When possible, use these
 methods; otherwise, you can add these options using either of the
 following syntax:
 
@@ -44,7 +44,7 @@ user-friendly interface and are the preferred way to add these options.
 
 .. include:: operator/max.txt
    :start-after: mongodb
-   
+
 .. include:: operator/min.txt
    :start-after: mongodb
 

source/reference/operator/comment.txt

@@ -14,5 +14,5 @@ $comment
 
    .. code-block:: javascript
 
-      db.collection.find( { <query> } )._addSpecial( "$comment", <comment to add> )
-      db.collection.find( { $query: { <query> }, $comment: <comment to add> } )
+      db.collection.find( { <query> } )._addSpecial( "$comment", <comment> )
+      db.collection.find( { $query: { <query> }, $comment: <comment> } )

source/reference/operator/max.txt

@@ -32,9 +32,9 @@ $max
 
       db.collection.find( { <query> } ).max( { age: 100 } )
 
-   This operation above limits the query to those documents where the
+   This operation limits the query to those documents where the
    field ``age`` is less than ``100`` using the index ``{ age: 1 }``.
-   
+
    You can explicitly specify the corresponding index with
    :method:`cursor.hint()`. Otherwise, MongoDB selects the index using
    the fields in the ``indexbounds``; however, if multiple indexes
@@ -49,14 +49,14 @@ $max
       { age: 1, type: -1 }
       { age: 1, type: 1 }
 
-   Without explicitly using :method:`cursor.hint()`, it is unclear
-   which index the following operation will select:
+   Without explicitly using :method:`cursor.hint()`, MongoDB may
+   select either index for the following operation:
 
    .. code-block:: javascript
 
       db.collection.find().max( { age: 50, type: 'B' } )
 
-   Use operation alone or in conjunction with :operator:`$min` to limit
+   Use :operator:`$max` alone or in conjunction with :operator:`$min` to limit
    results to a specific range for the *same* index, as in the
    following example:
 
@@ -75,5 +75,5 @@ $max
 
          db.collection.find( { _id: 7 } ).max( { age: 25 } )
 
-      The query will use the index on the ``age`` field, even if the
+      The query uses the index on the ``age`` field, even if the
       index on ``_id`` may be better.

source/reference/operator/min.txt

@@ -23,8 +23,8 @@ $min
       db.collection.find( { $query: { <query> }, $min: { field1: <min value1>, ... fieldN: <min valueN> } } )
 
    The :operator:`$min` specifies the lower bound for *all* keys of a
-   specific index *in order*. 
-   
+   specific index *in order*.
+
    Consider the following operations on a collection named
    ``collection`` that has an index ``{ age: 1 }``:
 
@@ -59,7 +59,7 @@ $min
    You can use :operator:`$min` in conjunction with :operator:`$max` to
    limit results to a specific range for the *same* index, as in the
    following example:
-   
+
    .. code-block:: javascript
 
       db.collection.find().min( { age: 20 } ).max( { age: 25 } )

source/reference/operator/query.txt

@@ -19,6 +19,6 @@ $query
    .. code-block:: javascript
 
       db.collection.find( { age : 25 } )
-      
+
    These operations return only those documents in the collection named
    ``collection`` where the ``age`` field equals ``25``.

source/reference/operator/snapshot.txt

@@ -39,7 +39,6 @@ $snapshot
         :operator:`$orderby` (or the corresponding
         :method:`cursor.hint()` and :method:`cursor.sort()` methods.)
 
-   .. [#snapshot-alternative]
-
-      You can achieve the :operator:`$snapshot` isolation behavior
-      using any *unique* index on invariable fields.
+   .. [#snapshot-alternative] You can achieve the
+      :operator:`$snapshot` isolation behavior using any *unique*
+      index on invariable fields.