MK feedback

Author: rachel-mack

source/crud/read-operations/retrieve.txt

@@ -52,19 +52,22 @@ track of the color and quantity, which corresponds to the ``color`` and
 Find Operation
 --------------
 
-Use the find operation to retrieve a subset of your existing data in
-MongoDB. You can specify what data to return including which documents
-to retrieve, in what order to retrieve them, and how many to retrieve.
+Use the find operation to retrieve your documents from MongoDB. You can specify
+which documents to retrieve, in what order to retrieve them, and how many to
+retrieve. 
 
 To perform a find operation, call the ``find()`` method on an instance
 of a ``MongoCollection``. This method searches a collection for documents that
 match the query filter you provide. For more information about how to
 specify a query, see our :ref:`Specify a Query
 <java-query>` guide.
 
-To retrieve a single document, you can append the ``first()`` method to your
-``find()`` operation. You can use the ``sort()`` operation before selecting the first
-document to help choose the correct file.
+To retrieve a single document, you can add the ``first()`` method to your
+``find()`` call. To choose a specific document, you can use the ``sort()``
+operation before selecting the first document. You may also want to use the
+``limit()`` method to optimize memory usage. For more information, see the
+server manual for more information about :manual:`memory optimization when using
+the sort operation </reference/operator/aggregation/sort/#-sort----limit-memory-optimization>`. 
 
 Example
 ~~~~~~~
@@ -116,9 +119,9 @@ This example is a complete, standalone file that performs the following actions:
       :language: none
       :visible: false
 
-      Number of documents found with find(): 101
+      10 movies under 15 minutes: 10 Minutes, 3x3, 7:35 in the Morning, 8, 9, A Chairy Tale, A Corner in Wheat, A Gentle Spirit, A Is for Autism, A Movie, 
 
-      Document found with find().first(): {"title": "The Room", "imdb": {"rating": 3.5, "votes": 25673, "id": 368226}}
+      The highest rated movie under 15 minutes: {"title": "Andrè and Wally B.", "imdb": {"rating": 5.4, "votes": 3294, "id": 86855}}
 
 .. _retrieve-aggregate:
 
@@ -181,6 +184,7 @@ on this page, see the following API documentation:
 
 - `find() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#find()>`__
 - `first() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoIterable.html#first()>`__
+- `limit() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html#limit(int)>`__
 - `FindIterable <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html>`__
 - `aggregate() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`__
 
@@ -190,4 +194,6 @@ Server Manual Entries
 - :manual:`Collections </core/databases-and-collections/#collections>`
 - :manual:`Query Documents </tutorial/query-documents>`
 - :manual:`Aggregation </aggregation>`
+   - :manual:`$sort </aggregation/sort>`
+   - :manual:`$limit </aggregation/limit>`
 - :manual:`Aggregation stages </meta/aggregation-quick-reference/#stages>`

source/includes/crud/Find.java

@@ -27,31 +27,34 @@ public static void main( String[] args ) {
             MongoDatabase database = mongoClient.getDatabase("sample_mflix");
             MongoCollection<Document> collection = database.getCollection("movies");
 
-            // Creates instructions to project two document fields
+            // Projects "title" and "imdb" fields, excludes "_id"
             Bson projectionFields = Projections.fields(
                     Projections.include("title", "imdb"),
                     Projections.excludeId());
 
-            // Retrieves documents that match the filter, applying a projection and a descending sort to the results
-            MongoCursor<Document> cursor = collection.find(lt("runtime", 15))
+            // Retrieves documents with a runtime of less than 15 minutes, applying the
+            // projection and a sorting in alphabetical order
+            FindIterable<Document> docs = collection.find(lt("runtime", 15))
                     .projection(projectionFields)
-                    .sort(Sorts.descending("title")).iterator();
+                    .sort(Sorts.ascending("title"))
+                    .limit(10);
 
             // Prints the results of the find operation as JSON
-            System.out.println("Number of documents found with find(): " + cursor.available() + "\n");
-            cursor.close();
+            System.out.print("10 movies under 15 minutes: ");
+            docs.forEach(doc -> System.out.print(doc.get("title") + ", "));
 
-            // Retrieves the first matching document, applying a projection and a descending sort to the results
-            Document doc = collection.find(eq("title", "The Room"))
+            // Retrieves the document with the best imdb rating that is less
+            // than 15 minutes long, applying the projection
+            Document doc = collection.find(lt("runtime", 15))
                     .projection(projectionFields)
-                    .sort(Sorts.descending("imdb.rating"))
+                    .sort(Sorts.ascending("imdb.rating"))
                     .first();
 
-            // Prints a message if there are no result documents, or prints the result document as JSON
+            // Prints result document as JSON
             if (doc == null) {
                 System.out.println("No results found.");
             } else {
-                System.out.println("Document found with find().first(): " + doc.toJson());
+                System.out.println("\n\nThe highest rated movie under 15 minutes: " + doc.toJson());
             }
         }
     }