DOCSP-33796-for-of-update (#5353) (#5560)

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

* DOCSP-33796-for-of-update

---------

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/method/cursor.forEach.txt

@@ -10,62 +10,87 @@ cursor.forEach()
    :depth: 1
    :class: singlecol
 
-Description
------------
+Definition
+----------
 
 .. method:: cursor.forEach(function)
 
-
    .. include:: /includes/fact-mongosh-shell-method.rst
 
-
    Iterates the cursor to apply a JavaScript ``function`` to each
    document from the cursor.
 
-   The :method:`~cursor.forEach()` method has the following prototype
-   form:
+Syntax
+------
 
-   .. code-block:: javascript
+The method has the following syntax:
 
-      db.collection.find().forEach(<function>)
+.. code-block:: javascript
+   :copyable: false
 
-   The :method:`~cursor.forEach()` method has the following parameter:
+   db.collection.find().forEach( <function> )
 
+Method Fields
+-------------
 
-   .. list-table::
-      :header-rows: 1
-      :widths: 20 20 80
-   
-      * - Parameter
-   
-        - Type
-   
-        - Description
-   
-      * - ``function``
-   
-        - JavaScript
-   
-        - A JavaScript function to apply to each document from the cursor. The
-          ``<function>`` signature includes a single argument that is passed the
-          current document to process.
-          
-          
-   
+The method accepts the following field:
 
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
 
-Example
--------
+   * - Field
+     - Type
+     - Description
 
-The following example invokes the :method:`~cursor.forEach()` method
-on the cursor returned by :method:`~db.collection.find()` to print
-the name of each user in the collection:
+   * - ``function``
+     - JavaScript code
+     - Function to apply to each document returned from the cursor. The
+       function signature includes one field that stores the current
+       document that is read from the cursor.
 
-.. code-block:: javascript
+Examples
+--------
+
+Create the ``users`` collection:
+
+.. code-block:: none
+
+   db.users.insertMany( [
+      { name: "John" },
+      { name: "Jane" }
+   ] )
+
+The following example uses ``forEach()`` with the
+:method:`~db.collection.find()` method to print the user names that are
+read from the ``users`` collection. ``myDoc`` stores the current
+document.
+
+.. code-block:: none
+
+   db.users.find().forEach( function( myDoc ) {
+      print( "User name: " + myDoc.name )
+   } )
+
+Example output:
+
+.. code-block:: none
+   :copyable: false
+
+   User name: John
+   User name: Jane
+
+Starting in :binary:`~bin.mongosh` 2.1.0, you can also use ``for-of``
+loops. The following example returns the same results as the previous
+example:
 
-   db.users.find().forEach( function(myDoc) { print( "user: " + myDoc.name ); } );
+.. code-block:: none
 
-.. seealso::
+   for ( const myDoc of db.users.find() ) {
+      print( "User name: " + myDoc.name )
+   }
 
-   :method:`cursor.map()` for similar functionality.
+Learn More
+----------
 
+For a method that has similar functionality, see :method:`cursor.map()`.