[DOCSP-50122] Remove next() info on explain() method {consistency} (#12290) (#12395)

Author: marcodeltorob

content/manual/upcoming/source/includes/fact-explain-methods-differences.rst

@@ -6,12 +6,6 @@ following key differences:
   additional chaining of query modifiers. For list of query modifiers,
   see :ref:`db.collection.explain().find().help() <explain-method-help>`.
 
-- The :method:`db.collection.find().explain() <db.collection.explain()>` returns a cursor, which
-  requires a call to ``.next()``, or its alias ``.finish()``, to return
-  the ``explain()`` results.
-  If run interactively in :binary:`~bin.mongosh`,
-  :binary:`~bin.mongosh` automatically calls ``.finish()`` to return
-  the results. For scripts, however, you must explicitly call
-  ``.next()``, or ``.finish()``, to return the results. For list of
-  cursor-related methods, see
-  :ref:`db.collection.explain().find().help() <explain-method-help>`.
+- The :method:`db.collection.find().explain() <db.collection.explain()>` returns
+  the ``explain()`` information on the query plan.
+  

content/manual/upcoming/source/reference/method/db.collection.explain.txt

@@ -299,17 +299,3 @@ For a list of query modifiers available, run the following in
 .. code-block:: javascript
 
    db.collection.explain().find().help()
-
-Iterate the ``explain().find()`` Return Cursor
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:method:`db.collection.explain().find() <db.collection.explain()>` 
-returns a cursor to the explain results. If run interactively in
-:binary:`~bin.mongosh`, :binary:`~bin.mongosh` automatically 
-iterates the cursor using the ``.next()`` method. For scripts, however, 
-you must explicitly call ``.next()`` (or its alias ``.finish()``) to 
-return the results:
-
-.. code-block:: javascript
-
-   var explainResult = db.products.explain().find( { category: "apparel" } ).next();

content/manual/v6.0/source/includes/fact-explain-methods-differences.rst

@@ -6,12 +6,6 @@ following key differences:
   additional chaining of query modifiers. For list of query modifiers,
   see :ref:`db.collection.explain().find().help() <explain-method-help>`.
 
-- The :method:`db.collection.find().explain() <db.collection.explain()>` returns a cursor, which
-  requires a call to ``.next()``, or its alias ``.finish()``, to return
-  the ``explain()`` results.
-  If run interactively in :binary:`~bin.mongosh`,
-  :binary:`~bin.mongosh` automatically calls ``.finish()`` to return
-  the results. For scripts, however, you must explicitly call
-  ``.next()``, or ``.finish()``, to return the results. For list of
-  cursor-related methods, see
-  :ref:`db.collection.explain().find().help() <explain-method-help>`.
+- The :method:`db.collection.find().explain() <db.collection.explain()>` returns
+  the ``explain()`` information on the query plan.
+  

content/manual/v6.0/source/reference/method/db.collection.explain.txt

@@ -283,17 +283,3 @@ For a list of query modifiers available, run the following in
 .. code-block:: javascript
 
    db.collection.explain().find().help()
-
-Iterate the ``explain().find()`` Return Cursor
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:method:`db.collection.explain().find() <db.collection.explain()>` 
-returns a cursor to the explain results. If run interactively in
-:binary:`~bin.mongosh`, :binary:`~bin.mongosh` automatically 
-iterates the cursor using the ``.next()`` method. For scripts, however, 
-you must explicitly call ``.next()`` (or its alias ``.finish()``) to 
-return the results:
-
-.. code-block:: javascript
-
-   var explainResult = db.products.explain().find( { category: "apparel" } ).next();

content/manual/v7.0/source/includes/fact-explain-methods-differences.rst

@@ -6,12 +6,6 @@ following key differences:
   additional chaining of query modifiers. For list of query modifiers,
   see :ref:`db.collection.explain().find().help() <explain-method-help>`.
 
-- The :method:`db.collection.find().explain() <db.collection.explain()>` returns a cursor, which
-  requires a call to ``.next()``, or its alias ``.finish()``, to return
-  the ``explain()`` results.
-  If run interactively in :binary:`~bin.mongosh`,
-  :binary:`~bin.mongosh` automatically calls ``.finish()`` to return
-  the results. For scripts, however, you must explicitly call
-  ``.next()``, or ``.finish()``, to return the results. For list of
-  cursor-related methods, see
-  :ref:`db.collection.explain().find().help() <explain-method-help>`.
+- The :method:`db.collection.find().explain() <db.collection.explain()>` returns
+  the ``explain()`` information on the query plan.
+  

content/manual/v7.0/source/reference/method/db.collection.explain.txt

@@ -283,17 +283,3 @@ For a list of query modifiers available, run the following in
 .. code-block:: javascript
 
    db.collection.explain().find().help()
-
-Iterate the ``explain().find()`` Return Cursor
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:method:`db.collection.explain().find() <db.collection.explain()>` 
-returns a cursor to the explain results. If run interactively in
-:binary:`~bin.mongosh`, :binary:`~bin.mongosh` automatically 
-iterates the cursor using the ``.next()`` method. For scripts, however, 
-you must explicitly call ``.next()`` (or its alias ``.finish()``) to 
-return the results:
-
-.. code-block:: javascript
-
-   var explainResult = db.products.explain().find( { category: "apparel" } ).next();