SA review

Author: lindseymoore

source/code-snippets/usage-examples/find.js

@@ -14,11 +14,11 @@ async function run() {
 
     // Query for movies that have a runtime less than 15 minutes
     const query = { runtime: { $lt: 15 } };
-    const sort = { title: 1 };
-    const projection = { _id: 0, title: 1, imdb: 1 };
+    const sortFields = { title: 1 };
+    const projectFields = { _id: 0, title: 1, imdb: 1 };
 
     // Execute query 
-    const cursor = movies.find(query).sort(sort).project(projection);
+    const cursor = movies.find(query).sort(sortFields).project(projectFields);
 
     // Print a message if no documents were found
     if ((await movies.countDocuments(query)) === 0) {

source/code-snippets/usage-examples/find.ts

@@ -25,10 +25,10 @@ async function run() {
     const movies = database.collection<Movie>("movies");
 
     const query = { runtime: { $lt: 15 } };
-    const sort = { title: 1 };
-    const projection = { _id: 0, title: 1, imdb: 1 };
+    const sortFields = { title: 1 };
+    const projectFields = { _id: 0, title: 1, imdb: 1 };
 
-    const cursor = movies.find<Movie>(query).sort(sort).project(projection);
+    const cursor = movies.find<Movie>(query).sort(sortFields).project(projectFields);
 
     if ((await movies.countDocuments(query)) === 0) {
       console.warn("No documents found!");

source/crud/query/project.txt

@@ -150,8 +150,4 @@ the following results:
 For more projection examples, see the
 :manual:`MongoDB Manual page on Project Fields to Return from Query </tutorial/project-fields-from-query-results/>`.
 
-.. note::
-
-   You must chain a cursor method such as ``project()`` to a read operation 
-   before iterating the cursor. If you specify a projection after 
-   iterating the cursor, the projection does not apply to the operation.
+.. include:: /includes/crud/chain-cursor-methods.rst 

source/crud/query/retrieve.txt

@@ -235,12 +235,7 @@ Running the preceding example results in the following output:
    { title: '8', imdb: { rating: 7.8, votes: 883, id: 1592502 } }
    ...
 
-.. note::
-
-   You must chain cursor methods such as ``sort()`` or ``project()`` 
-   to a read operation before iterating the cursor. If you specify 
-   a cursor method after iterating the cursor, the setting does not 
-   apply to the read operation.  
+.. include:: /includes/crud/chain-cursor-methods.rst 
 
 Additional Information
 ~~~~~~~~~~~~~~~~~~~~~~

source/crud/query/specify-documents-to-return.txt

@@ -47,12 +47,7 @@ that describe books into the ``myDB.books`` collection:
      { "_id": 6, "name": "A Dance With Dragons", "author": "Martin", "length": 1104 },
    ]);
 
-.. note::
-
-   You must chain a cursor method such as ``sort()``, ``limit()``, or 
-   ``skip()`` to a read operation before iterating the cursor. If you specify 
-   a cursor method after iterating the cursor, the setting does not 
-   apply to the read operation.  
+.. include:: /includes/crud/chain-cursor-methods.rst 
 
 .. include:: /includes/access-cursor-note.rst
 

source/includes/crud/chain-cursor-methods.rst

@@ -0,0 +1,6 @@
+.. note::
+
+   You must chain a cursor method such as ``sort()``, ``limit()``, 
+   ``skip()``, or ``project()`` to a read operation before iterating the cursor. 
+   If you specify a cursor method after iterating the cursor, the setting does 
+   not apply to the read operation.