(DOCSP-26616): Clarify node driver output (#2380)

* (DOCSP-26616): Clarify node driver output

* cleanup

* wording

* move include location

* move blurb higher up on page

* edits

* remove extra lines

* minimalism

* wording

* apply text to all query documents pages

* wording

* add include to query for null page

* move include location

* formatting

* wording

* clarifications based on review

* formatting

Author: jeff-allen-mongo

source/tutorial/query-arrays.txt

@@ -148,4 +148,3 @@ For additional query examples, see:
 - :doc:`/tutorial/query-embedded-documents`
 
 - :doc:`/tutorial/query-array-of-documents`
-

source/tutorial/query-documents.txt

@@ -43,7 +43,8 @@ Select All Documents in a Collection
 
 .. include:: /includes/driver-examples/driver-example-query-7.rst
 
-This operation corresponds to the following SQL statement:
+This operation uses a filter predicate of ``{}``, which corresponds to
+the following SQL statement:
 
 .. code-block:: sql
 
@@ -80,7 +81,8 @@ This operation corresponds to the following SQL statement:
 
      - id: nodejs
        content: |
-         For more information on the syntax of the method, see
+
+         To see supported options for the ``find()`` method, see
          :node-api:`find() <Collection.html#find>`.
 
      - id: php
@@ -120,7 +122,8 @@ documents where the ``status`` equals ``"D"``:
 
 .. include:: /includes/driver-examples/driver-example-query-9.rst
 
-This operation corresponds to the following SQL statement:
+This operation uses a filter predicate of ``{ status: "D" }``, which
+corresponds to the following SQL statement:
 
 .. code-block:: sql
 
@@ -153,7 +156,9 @@ collection where ``status`` equals either ``"A"`` or ``"D"``:
    use the :query:`$in` operator rather than the :query:`$or`
    operator when performing equality checks on the same field.
 
-The operation corresponds to the following SQL statement:
+The operation uses a filter predicate of
+``{ status: { $in: [ "A", "D" ] } }``, which corresponds to the
+following SQL statement:
 
 .. code-block:: sql
 
@@ -176,7 +181,9 @@ than (:query:`$lt`) ``30``:
 
 .. include:: /includes/driver-examples/driver-example-query-11.rst
 
-The operation corresponds to the following SQL statement:
+The operation uses a filter predicate of
+``{ status: "A", qty: { $lt: 30 } }``, which corresponds to the
+following SQL statement:
 
 .. code-block:: sql
 
@@ -199,18 +206,21 @@ the ``status`` equals ``"A"`` **or** ``qty`` is less than
 
 .. include:: /includes/driver-examples/driver-example-query-12.rst
 
-The operation corresponds to the following SQL statement:
+The operation uses a filter predicate of
+``{ $or: [ { status: 'A' }, { qty: { $lt: 30 } } ] }``, which
+corresponds to the following SQL statement:
 
 .. code-block:: sql
 
    SELECT * FROM inventory WHERE status = "A" OR qty < 30
 
 .. note::
-   Queries which use :ref:`comparison operators <query-selectors-comparison>`
-   are subject to :ref:`type-bracketing`.
+
+   Queries that use :ref:`comparison operators
+   <query-selectors-comparison>` are subject to :ref:`type-bracketing`.
 
 Specify ``AND`` as well as ``OR`` Conditions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------------------------
 
 In the following example, the compound query document selects all
 documents in the collection where the ``status`` equals ``"A"``
@@ -219,7 +229,18 @@ documents in the collection where the ``status`` equals ``"A"``
 
 .. include:: /includes/driver-examples/driver-example-query-13.rst
 
-The operation corresponds to the following SQL statement:
+The operation uses a filter predicate of:
+
+.. code-block:: javascript
+   
+   {
+      status: 'A',
+      $or: [
+        { qty: { $lt: 30 } }, { item: { $regex: '^p' } }
+      ]
+   }
+   
+which corresponds to the following SQL statement:
 
 .. code-block:: sql
 
@@ -349,6 +370,17 @@ For reads to :doc:`replica sets </replication>` and replica set
 level of isolation for their reads. For more information, see
 :doc:`/reference/read-concern`.
 
+Query Result Format
+~~~~~~~~~~~~~~~~~~~
+
+When you run a find operation with a MongoDB driver or ``mongosh``, the
+command returns a :term:`cursor` that manages query results. The query
+results are not returned as an array of documents.
+
+To learn how to iterate through documents in a cursor, refer to your
+:driver:`driver's documentation </>`. If you are using ``mongosh``, see
+:ref:`read-operations-cursors`.
+
 .. tabs-drivers::
 
    tabs:

source/tutorial/query-for-null-fields.txt

@@ -370,4 +370,3 @@ The query only returns the document that does *not* contain the
 .. [#type0]
 
    .. include:: /includes/extracts/4.2-changes-type-0.rst
-