From e3433ced54bea04e8154292dc5b6b6589c500646 Mon Sep 17 00:00:00 2001
From: Dave Cuthbert <dave.cuthbert@mongodb.com>
Date: Tue, 20 Apr 2021 14:02:54 -0400
Subject: [PATCH] DOCSP-15489 update mongo shell banner for mongosh

---
 .../includes/fact-mongo-shell-method-toc.rst  |  5 -----
 source/includes/fact-mongo-shell-method.rst   |  7 -------
 .../fact-mongosh-shell-method-toc.rst         | 18 +++++++++++++++++
 source/includes/fact-mongosh-shell-method.rst | 20 +++++++++++++++++++
 source/reference/method.txt                   |  6 +++---
 source/reference/method/cursor.addOption.txt  |  2 +-
 .../reference/method/cursor.allowDiskUse.txt  |  2 +-
 .../method/cursor.allowPartialResults.txt     |  2 +-
 source/reference/method/cursor.batchSize.txt  |  2 +-
 source/reference/method/cursor.close.txt      |  2 +-
 source/reference/method/cursor.collation.txt  |  2 +-
 source/reference/method/cursor.comment.txt    |  2 +-
 source/reference/method/cursor.count.txt      |  2 +-
 source/reference/method/cursor.explain.txt    |  2 +-
 source/reference/method/cursor.forEach.txt    |  2 +-
 source/reference/method/cursor.hasNext.txt    |  2 +-
 source/reference/method/cursor.hint.txt       |  2 +-
 source/reference/method/cursor.isClosed.txt   |  2 +-
 .../reference/method/cursor.isExhausted.txt   |  2 +-
 source/reference/method/cursor.itcount.txt    |  2 +-
 source/reference/method/cursor.limit.txt      |  2 +-
 source/reference/method/cursor.map.txt        |  2 +-
 source/reference/method/cursor.max.txt        |  2 +-
 source/reference/method/cursor.maxTimeMS.txt  |  2 +-
 source/reference/method/cursor.min.txt        |  2 +-
 source/reference/method/cursor.next.txt       |  2 +-
 .../method/cursor.noCursorTimeout.txt         |  2 +-
 .../method/cursor.objsLeftInBatch.txt         |  2 +-
 source/reference/method/cursor.pretty.txt     |  2 +-
 .../reference/method/cursor.readConcern.txt   |  2 +-
 source/reference/method/cursor.readPref.txt   |  2 +-
 source/reference/method/cursor.returnKey.txt  |  2 +-
 .../reference/method/cursor.showRecordId.txt  |  2 +-
 source/reference/method/cursor.size.txt       |  2 +-
 source/reference/method/cursor.skip.txt       |  2 +-
 source/reference/method/cursor.sort.txt       |  2 +-
 source/reference/method/cursor.tailable.txt   |  2 +-
 source/reference/method/cursor.toArray.txt    |  2 +-
 source/reference/method/db.adminCommand.txt   |  2 ++
 .../method/db.collection.aggregate.txt        |  2 +-
 .../method/db.collection.bulkWrite.txt        |  2 +-
 .../reference/method/db.collection.copyTo.txt |  2 +-
 .../reference/method/db.collection.count.txt  |  2 +-
 .../method/db.collection.countDocuments.txt   |  2 +-
 .../method/db.collection.createIndex.txt      |  2 +-
 .../method/db.collection.createIndexes.txt    |  2 +-
 .../method/db.collection.dataSize.txt         |  2 +-
 .../method/db.collection.deleteMany.txt       |  2 +-
 .../method/db.collection.deleteOne.txt        |  2 +-
 .../method/db.collection.distinct.txt         |  2 +-
 .../reference/method/db.collection.drop.txt   |  2 +-
 .../method/db.collection.dropIndex.txt        |  2 +-
 .../method/db.collection.dropIndexes.txt      |  2 +-
 .../db.collection.estimatedDocumentCount.txt  |  2 +-
 .../method/db.collection.explain.txt          |  2 +-
 .../reference/method/db.collection.find.txt   |  2 +-
 .../method/db.collection.findAndModify.txt    |  2 +-
 .../method/db.collection.findOne.txt          |  2 +-
 .../method/db.collection.findOneAndDelete.txt |  2 +-
 .../db.collection.findOneAndReplace.txt       |  2 +-
 .../method/db.collection.findOneAndUpdate.txt |  2 +-
 .../method/db.collection.getIndexes.txt       |  2 +-
 .../method/db.collection.getPlanCache.txt     |  2 +-
 .../db.collection.getShardDistribution.txt    |  2 +-
 .../method/db.collection.getShardVersion.txt  |  2 +-
 .../method/db.collection.hideIndex.txt        |  2 +-
 .../db.collection.initializeOrderedBulkOp.txt |  2 +-
 ...b.collection.initializeUnorderedBulkOp.txt |  2 +-
 .../reference/method/db.collection.insert.txt |  2 +-
 .../method/db.collection.insertMany.txt       |  2 +-
 .../method/db.collection.insertOne.txt        |  2 +-
 .../method/db.collection.isCapped.txt         |  2 +-
 .../method/db.collection.latencyStats.txt     |  2 +-
 .../method/db.collection.mapReduce.txt        |  2 +-
 .../method/db.collection.reIndex.txt          |  2 +-
 .../reference/method/db.collection.remove.txt |  2 +-
 .../method/db.collection.renameCollection.txt |  2 +-
 .../method/db.collection.replaceOne.txt       |  2 +-
 .../reference/method/db.collection.save.txt   |  2 +-
 .../reference/method/db.collection.stats.txt  |  2 +-
 .../method/db.collection.storageSize.txt      |  2 +-
 .../method/db.collection.totalIndexSize.txt   |  2 +-
 .../method/db.collection.totalSize.txt        |  2 +-
 .../method/db.collection.unhideIndex.txt      |  2 +-
 .../reference/method/db.collection.update.txt |  2 +-
 .../method/db.collection.updateMany.txt       |  2 +-
 .../method/db.collection.updateOne.txt        |  2 +-
 .../method/db.collection.validate.txt         |  2 +-
 .../reference/method/db.collection.watch.txt  |  2 +-
 source/reference/method/db.getMongo.txt       |  9 +++++++++
 source/reference/method/js-collection.txt     |  4 ++--
 source/reference/method/js-cursor.txt         |  4 ++--
 92 files changed, 139 insertions(+), 102 deletions(-)
 delete mode 100644 source/includes/fact-mongo-shell-method-toc.rst
 delete mode 100644 source/includes/fact-mongo-shell-method.rst
 create mode 100644 source/includes/fact-mongosh-shell-method-toc.rst
 create mode 100644 source/includes/fact-mongosh-shell-method.rst

diff --git a/source/includes/fact-mongo-shell-method-toc.rst b/source/includes/fact-mongo-shell-method-toc.rst
deleted file mode 100644
index de9cbc54114..00000000000
--- a/source/includes/fact-mongo-shell-method-toc.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-The methods listed on this table of contents page refer to the
-:binary:`~bin.mongo` shell methods, and *not* to the MongoDB Node.js
-driver (or any other driver) methods. For corresponding MongoDB driver
-API, refer to your specific :driver:`MongoDB driver </>`
-documentation instead.
diff --git a/source/includes/fact-mongo-shell-method.rst b/source/includes/fact-mongo-shell-method.rst
deleted file mode 100644
index 2320429354e..00000000000
--- a/source/includes/fact-mongo-shell-method.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-.. important:: ``mongo`` Shell Method
-
-
-   This page documents the :binary:`~bin.mongo` shell method, and does
-   *not* refer to the MongoDB Node.js driver (or any other driver)
-   method. For corresponding MongoDB driver API, refer to your specific
-   :driver:`MongoDB driver </>` documentation instead.
diff --git a/source/includes/fact-mongosh-shell-method-toc.rst b/source/includes/fact-mongosh-shell-method-toc.rst
new file mode 100644
index 00000000000..a3d73715e3b
--- /dev/null
+++ b/source/includes/fact-mongosh-shell-method-toc.rst
@@ -0,0 +1,18 @@
+The methods listed on this table of contents page are
+:mongosh:`mongosh </>` methods.  This is *not* the documention for
+``Node.js`` or other programming language specific driver methods.
+
+In most cases :mongosh:`mongosh </>` methods work the same way as the
+legacy :binary:`~bin.mongo` shell methods. However, some legacy methods
+are unavailable in ``mongosh``.
+
+For legacy :binary:`~bin.mongo` shell documention, refer to the
+documentation for the corresponding ``MongoDB`` release.
+
+- :v4.4:`mongo shell v4.4 </mongo>`
+- :v4.2:`mongo shell v4.2 </mongo>`
+- :v4.0:`mongo shell v4.0 </mongo>`
+
+For MongoDB API drivers, refer to the language specific
+:driver:`MongoDB driver </>` documentation.
+
diff --git a/source/includes/fact-mongosh-shell-method.rst b/source/includes/fact-mongosh-shell-method.rst
new file mode 100644
index 00000000000..ddf0ef3296b
--- /dev/null
+++ b/source/includes/fact-mongosh-shell-method.rst
@@ -0,0 +1,20 @@
+.. important:: ``mongosh`` Method
+
+   This is a :mongosh:`mongosh </>` method. This is *not* the
+   documention for ``Node.js`` or other programming language specific
+   driver methods.
+
+   In most cases :mongosh:`mongosh </>` methods work the same way as
+   the legacy :binary:`~bin.mongo` shell methods. However, some legacy
+   methods are unavailable in ``mongosh``.
+
+   For legacy :binary:`~bin.mongo` shell documention, refer to the
+   documentation for the corresponding ``MongoDB`` release.
+
+   - :v4.4:`mongo shell v4.4 </mongo>`
+   - :v4.2:`mongo shell v4.2 </mongo>`
+   - :v4.0:`mongo shell v4.0 </mongo>`
+
+   For MongoDB API drivers, refer to the language specific
+   :driver:`MongoDB driver </>` documentation.
+
diff --git a/source/reference/method.txt b/source/reference/method.txt
index 2f43ac8c27b..c44bcdf39a9 100644
--- a/source/reference/method.txt
+++ b/source/reference/method.txt
@@ -1,8 +1,8 @@
 .. _js-administrative-methods:
 
-=======================
-``mongo`` Shell Methods
-=======================
+===================
+``mongosh`` Methods
+===================
 
 .. default-domain:: mongodb
 
diff --git a/source/reference/method/cursor.addOption.txt b/source/reference/method/cursor.addOption.txt
index fc1f4f67e4c..853cbc0d08f 100644
--- a/source/reference/method/cursor.addOption.txt
+++ b/source/reference/method/cursor.addOption.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.addOption(flag)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. include:: /includes/extracts/mongo-shell-deprecated-meta-operator-cursor-addOption.rst
diff --git a/source/reference/method/cursor.allowDiskUse.txt b/source/reference/method/cursor.allowDiskUse.txt
index 4409c757fab..443b11b80cd 100644
--- a/source/reference/method/cursor.allowDiskUse.txt
+++ b/source/reference/method/cursor.allowDiskUse.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: cursor.allowDiskUse()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    :method:`~cursor.allowDiskUse()` allows MongoDB to use temporary
    files on disk to store data exceeding the 100 megabyte system memory
diff --git a/source/reference/method/cursor.allowPartialResults.txt b/source/reference/method/cursor.allowPartialResults.txt
index 5e22dd2035a..a3750159fe3 100644
--- a/source/reference/method/cursor.allowPartialResults.txt
+++ b/source/reference/method/cursor.allowPartialResults.txt
@@ -15,7 +15,7 @@ Definition
 
 .. method:: cursor.allowPartialResults()
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    When used with :method:`db.collection.find()` operations against a
    sharded collection, returns partial results, rather than an error,
diff --git a/source/reference/method/cursor.batchSize.txt b/source/reference/method/cursor.batchSize.txt
index 2cb0892d81a..93547786119 100644
--- a/source/reference/method/cursor.batchSize.txt
+++ b/source/reference/method/cursor.batchSize.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.batchSize(size)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Specifies the
diff --git a/source/reference/method/cursor.close.txt b/source/reference/method/cursor.close.txt
index 36307294453..87e3c93b80e 100644
--- a/source/reference/method/cursor.close.txt
+++ b/source/reference/method/cursor.close.txt
@@ -10,7 +10,7 @@ Definition
 .. method:: cursor.close()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Instructs the server to close a :ref:`cursor <read-operations-cursors>`
diff --git a/source/reference/method/cursor.collation.txt b/source/reference/method/cursor.collation.txt
index 0d74f4eb45c..a954e83c020 100644
--- a/source/reference/method/cursor.collation.txt
+++ b/source/reference/method/cursor.collation.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: cursor.collation(<collation document>)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.4
diff --git a/source/reference/method/cursor.comment.txt b/source/reference/method/cursor.comment.txt
index 753544d76c2..2b3d0d1bbde 100644
--- a/source/reference/method/cursor.comment.txt
+++ b/source/reference/method/cursor.comment.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.comment()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/cursor.count.txt b/source/reference/method/cursor.count.txt
index 8eee3268ae9..4975bee1c93 100644
--- a/source/reference/method/cursor.count.txt
+++ b/source/reference/method/cursor.count.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.count()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. note::
diff --git a/source/reference/method/cursor.explain.txt b/source/reference/method/cursor.explain.txt
index b2622aea871..a924c1872c2 100644
--- a/source/reference/method/cursor.explain.txt
+++ b/source/reference/method/cursor.explain.txt
@@ -15,7 +15,7 @@ Definition
 
 .. method:: cursor.explain(verbosity)
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Provides information on the query plan for the
    :method:`db.collection.find()` method.
diff --git a/source/reference/method/cursor.forEach.txt b/source/reference/method/cursor.forEach.txt
index dc512e30c6a..1c1f10aefb9 100644
--- a/source/reference/method/cursor.forEach.txt
+++ b/source/reference/method/cursor.forEach.txt
@@ -16,7 +16,7 @@ Description
 .. method:: cursor.forEach(function)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Iterates the cursor to apply a JavaScript ``function`` to each
diff --git a/source/reference/method/cursor.hasNext.txt b/source/reference/method/cursor.hasNext.txt
index ededa2734ca..140549f4603 100644
--- a/source/reference/method/cursor.hasNext.txt
+++ b/source/reference/method/cursor.hasNext.txt
@@ -13,7 +13,7 @@ cursor.hasNext()
 .. method:: cursor.hasNext()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: Boolean.
diff --git a/source/reference/method/cursor.hint.txt b/source/reference/method/cursor.hint.txt
index 2bb1c02a400..75d175537d1 100644
--- a/source/reference/method/cursor.hint.txt
+++ b/source/reference/method/cursor.hint.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.hint(index)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Call this method on a query to override MongoDB's default index
diff --git a/source/reference/method/cursor.isClosed.txt b/source/reference/method/cursor.isClosed.txt
index 82137362b97..42bbc2b187a 100644
--- a/source/reference/method/cursor.isClosed.txt
+++ b/source/reference/method/cursor.isClosed.txt
@@ -13,7 +13,7 @@ cursor.isClosed()
 .. method:: cursor.isClosed()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: Boolean.
diff --git a/source/reference/method/cursor.isExhausted.txt b/source/reference/method/cursor.isExhausted.txt
index 0c9d5be4980..47b500024f4 100644
--- a/source/reference/method/cursor.isExhausted.txt
+++ b/source/reference/method/cursor.isExhausted.txt
@@ -13,7 +13,7 @@ cursor.isExhausted()
 .. method:: cursor.isExhausted()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: Boolean.
diff --git a/source/reference/method/cursor.itcount.txt b/source/reference/method/cursor.itcount.txt
index 4caae29062d..4587626c1d9 100644
--- a/source/reference/method/cursor.itcount.txt
+++ b/source/reference/method/cursor.itcount.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.itcount()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Counts the number of documents remaining in a cursor.
diff --git a/source/reference/method/cursor.limit.txt b/source/reference/method/cursor.limit.txt
index e5a6edf31ff..a983b3fde3c 100644
--- a/source/reference/method/cursor.limit.txt
+++ b/source/reference/method/cursor.limit.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.limit()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Use the :method:`~cursor.limit()` method on a cursor to specify the maximum
diff --git a/source/reference/method/cursor.map.txt b/source/reference/method/cursor.map.txt
index 6b587ee3947..68536e28c1d 100644
--- a/source/reference/method/cursor.map.txt
+++ b/source/reference/method/cursor.map.txt
@@ -13,7 +13,7 @@ cursor.map()
 .. method:: cursor.map(function)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Applies ``function`` to each document visited by the cursor and
diff --git a/source/reference/method/cursor.max.txt b/source/reference/method/cursor.max.txt
index b7590910b13..c4bdb4b835b 100644
--- a/source/reference/method/cursor.max.txt
+++ b/source/reference/method/cursor.max.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.max()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Specifies the *exclusive* upper bound for a specific index in order
diff --git a/source/reference/method/cursor.maxTimeMS.txt b/source/reference/method/cursor.maxTimeMS.txt
index 44e12954d72..046a52f5e0e 100644
--- a/source/reference/method/cursor.maxTimeMS.txt
+++ b/source/reference/method/cursor.maxTimeMS.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.maxTimeMS(<time limit>)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Specifies a cumulative time limit in milliseconds for processing
diff --git a/source/reference/method/cursor.min.txt b/source/reference/method/cursor.min.txt
index 7e7fd89fc15..d6224b6126a 100644
--- a/source/reference/method/cursor.min.txt
+++ b/source/reference/method/cursor.min.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.min()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Specifies the *inclusive* lower bound for a specific index in order
diff --git a/source/reference/method/cursor.next.txt b/source/reference/method/cursor.next.txt
index 27b7a9d4d30..40f93bc0a21 100644
--- a/source/reference/method/cursor.next.txt
+++ b/source/reference/method/cursor.next.txt
@@ -13,7 +13,7 @@ cursor.next()
 .. method:: cursor.next()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: The next document in the cursor returned by the
diff --git a/source/reference/method/cursor.noCursorTimeout.txt b/source/reference/method/cursor.noCursorTimeout.txt
index ab581450cf4..f9dfd108e8a 100644
--- a/source/reference/method/cursor.noCursorTimeout.txt
+++ b/source/reference/method/cursor.noCursorTimeout.txt
@@ -10,7 +10,7 @@ Definition
 .. method:: cursor.noCursorTimeout()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Instructs the server to avoid closing a cursor automatically after a period
diff --git a/source/reference/method/cursor.objsLeftInBatch.txt b/source/reference/method/cursor.objsLeftInBatch.txt
index 324e6bd8b5e..2a12b8beb46 100644
--- a/source/reference/method/cursor.objsLeftInBatch.txt
+++ b/source/reference/method/cursor.objsLeftInBatch.txt
@@ -13,7 +13,7 @@ cursor.objsLeftInBatch()
 .. method:: cursor.objsLeftInBatch()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :method:`cursor.objsLeftInBatch()` returns the number of
diff --git a/source/reference/method/cursor.pretty.txt b/source/reference/method/cursor.pretty.txt
index f13af97812c..4106c18913b 100644
--- a/source/reference/method/cursor.pretty.txt
+++ b/source/reference/method/cursor.pretty.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.pretty()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Configures the cursor to display results in an easy-to-read format.
diff --git a/source/reference/method/cursor.readConcern.txt b/source/reference/method/cursor.readConcern.txt
index b1a3080e8b7..dae74a03284 100644
--- a/source/reference/method/cursor.readConcern.txt
+++ b/source/reference/method/cursor.readConcern.txt
@@ -17,7 +17,7 @@ Definition
 .. method:: cursor.readConcern(level)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/cursor.readPref.txt b/source/reference/method/cursor.readPref.txt
index 52f9b448abd..c66236a6d55 100644
--- a/source/reference/method/cursor.readPref.txt
+++ b/source/reference/method/cursor.readPref.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.readPref(mode, tagSet, hedgeOptions)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Append :method:`~cursor.readPref()` to a cursor to
diff --git a/source/reference/method/cursor.returnKey.txt b/source/reference/method/cursor.returnKey.txt
index c87d0c26b27..1324d827e61 100644
--- a/source/reference/method/cursor.returnKey.txt
+++ b/source/reference/method/cursor.returnKey.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.returnKey()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    .. tip::
 
diff --git a/source/reference/method/cursor.showRecordId.txt b/source/reference/method/cursor.showRecordId.txt
index b4929bc2054..9be86f6179c 100644
--- a/source/reference/method/cursor.showRecordId.txt
+++ b/source/reference/method/cursor.showRecordId.txt
@@ -13,7 +13,7 @@ cursor.showRecordId()
 .. method:: cursor.showRecordId()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionchanged:: 3.2
diff --git a/source/reference/method/cursor.size.txt b/source/reference/method/cursor.size.txt
index 488c4e049af..0c4c841ba5d 100644
--- a/source/reference/method/cursor.size.txt
+++ b/source/reference/method/cursor.size.txt
@@ -13,7 +13,7 @@ cursor.size()
 .. method:: cursor.size()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: A count of the number of documents that match the
diff --git a/source/reference/method/cursor.skip.txt b/source/reference/method/cursor.skip.txt
index 62baf24db65..1e8fbbe1317 100644
--- a/source/reference/method/cursor.skip.txt
+++ b/source/reference/method/cursor.skip.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.skip(<offset>)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Call the :method:`~cursor.skip()` method on a cursor to control where
diff --git a/source/reference/method/cursor.sort.txt b/source/reference/method/cursor.sort.txt
index f7671a2a3bc..8fbec572d9c 100644
--- a/source/reference/method/cursor.sort.txt
+++ b/source/reference/method/cursor.sort.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.sort(sort)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Specifies the order in which the query returns matching documents.
diff --git a/source/reference/method/cursor.tailable.txt b/source/reference/method/cursor.tailable.txt
index 5743bbd5c7d..ccc9380c0b0 100644
--- a/source/reference/method/cursor.tailable.txt
+++ b/source/reference/method/cursor.tailable.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: cursor.tailable()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/cursor.toArray.txt b/source/reference/method/cursor.toArray.txt
index 32d5eedab33..fc185c4f564 100644
--- a/source/reference/method/cursor.toArray.txt
+++ b/source/reference/method/cursor.toArray.txt
@@ -13,7 +13,7 @@ cursor.toArray()
 .. method:: cursor.toArray()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    The :method:`~cursor.toArray()` method returns an array that
diff --git a/source/reference/method/db.adminCommand.txt b/source/reference/method/db.adminCommand.txt
index 528dc23734c..ed44b22f473 100644
--- a/source/reference/method/db.adminCommand.txt
+++ b/source/reference/method/db.adminCommand.txt
@@ -10,6 +10,8 @@ db.adminCommand()
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-shell-method.rst
+
 Definition
 ----------
 
diff --git a/source/reference/method/db.collection.aggregate.txt b/source/reference/method/db.collection.aggregate.txt
index 4b605758c53..577f30dceab 100644
--- a/source/reference/method/db.collection.aggregate.txt
+++ b/source/reference/method/db.collection.aggregate.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.aggregate(pipeline, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Calculates aggregate values for the data in a collection or a :doc:`view </core/views>`.
diff --git a/source/reference/method/db.collection.bulkWrite.txt b/source/reference/method/db.collection.bulkWrite.txt
index c2b68583629..565716b9e04 100644
--- a/source/reference/method/db.collection.bulkWrite.txt
+++ b/source/reference/method/db.collection.bulkWrite.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.bulkWrite()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.copyTo.txt b/source/reference/method/db.collection.copyTo.txt
index 9020c2fa9ac..04c14b23713 100644
--- a/source/reference/method/db.collection.copyTo.txt
+++ b/source/reference/method/db.collection.copyTo.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.copyTo(newCollection)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. deprecated:: 3.0
diff --git a/source/reference/method/db.collection.count.txt b/source/reference/method/db.collection.count.txt
index 37dd804f02a..0589bd28ab2 100644
--- a/source/reference/method/db.collection.count.txt
+++ b/source/reference/method/db.collection.count.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.count(query, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. note::
diff --git a/source/reference/method/db.collection.countDocuments.txt b/source/reference/method/db.collection.countDocuments.txt
index 8a832735bc7..a5fe2bff781 100644
--- a/source/reference/method/db.collection.countDocuments.txt
+++ b/source/reference/method/db.collection.countDocuments.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.countDocuments(query, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 4.0.3
diff --git a/source/reference/method/db.collection.createIndex.txt b/source/reference/method/db.collection.createIndex.txt
index d5f8f7984d7..ff7de26e4b3 100644
--- a/source/reference/method/db.collection.createIndex.txt
+++ b/source/reference/method/db.collection.createIndex.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.createIndex(keys, options, commitQuorum)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Creates indexes on collections.
diff --git a/source/reference/method/db.collection.createIndexes.txt b/source/reference/method/db.collection.createIndexes.txt
index 9676e260f76..fad015d8848 100644
--- a/source/reference/method/db.collection.createIndexes.txt
+++ b/source/reference/method/db.collection.createIndexes.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.createIndexes( [ keyPatterns ], options, commitQuorum )
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Creates one or more indexes on a collection.
diff --git a/source/reference/method/db.collection.dataSize.txt b/source/reference/method/db.collection.dataSize.txt
index 565fe1087f3..143e4ef931f 100644
--- a/source/reference/method/db.collection.dataSize.txt
+++ b/source/reference/method/db.collection.dataSize.txt
@@ -13,7 +13,7 @@ db.collection.dataSize()
 .. method:: db.collection.dataSize()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: The size in bytes of the collection.
diff --git a/source/reference/method/db.collection.deleteMany.txt b/source/reference/method/db.collection.deleteMany.txt
index c5223e70a14..e975e389d9c 100644
--- a/source/reference/method/db.collection.deleteMany.txt
+++ b/source/reference/method/db.collection.deleteMany.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.deleteMany()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Removes all documents that match the ``filter`` from a collection.
diff --git a/source/reference/method/db.collection.deleteOne.txt b/source/reference/method/db.collection.deleteOne.txt
index 8eb12e039eb..aac393effd3 100644
--- a/source/reference/method/db.collection.deleteOne.txt
+++ b/source/reference/method/db.collection.deleteOne.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.deleteOne()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Removes a single document from a collection.
diff --git a/source/reference/method/db.collection.distinct.txt b/source/reference/method/db.collection.distinct.txt
index e2274899eab..5fcb84e6f7c 100644
--- a/source/reference/method/db.collection.distinct.txt
+++ b/source/reference/method/db.collection.distinct.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.distinct(field, query, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Finds the distinct
diff --git a/source/reference/method/db.collection.drop.txt b/source/reference/method/db.collection.drop.txt
index 5205d174d95..19d6a156016 100644
--- a/source/reference/method/db.collection.drop.txt
+++ b/source/reference/method/db.collection.drop.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.drop(<options>)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Removes a collection or :doc:`view </core/views>` from the database.
diff --git a/source/reference/method/db.collection.dropIndex.txt b/source/reference/method/db.collection.dropIndex.txt
index 2d73af02adc..da4747b4e52 100644
--- a/source/reference/method/db.collection.dropIndex.txt
+++ b/source/reference/method/db.collection.dropIndex.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.dropIndex(index)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Drops or removes the specified index from a collection. The
diff --git a/source/reference/method/db.collection.dropIndexes.txt b/source/reference/method/db.collection.dropIndexes.txt
index 178f07b36f9..84318e325e9 100644
--- a/source/reference/method/db.collection.dropIndexes.txt
+++ b/source/reference/method/db.collection.dropIndexes.txt
@@ -17,7 +17,7 @@ Definition
 .. method:: db.collection.dropIndexes()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Drops the specified index or indexes (except the index on the
diff --git a/source/reference/method/db.collection.estimatedDocumentCount.txt b/source/reference/method/db.collection.estimatedDocumentCount.txt
index 26e4122a0e9..620e6c51a24 100644
--- a/source/reference/method/db.collection.estimatedDocumentCount.txt
+++ b/source/reference/method/db.collection.estimatedDocumentCount.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.estimatedDocumentCount(options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 4.0.3
diff --git a/source/reference/method/db.collection.explain.txt b/source/reference/method/db.collection.explain.txt
index 843d482b984..609d3d5c70f 100644
--- a/source/reference/method/db.collection.explain.txt
+++ b/source/reference/method/db.collection.explain.txt
@@ -16,7 +16,7 @@ Description
 .. method:: db.collection.explain()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Returns information on the query plan for the following methods:
diff --git a/source/reference/method/db.collection.find.txt b/source/reference/method/db.collection.find.txt
index 979f9891f45..578b840a90b 100644
--- a/source/reference/method/db.collection.find.txt
+++ b/source/reference/method/db.collection.find.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.find(query, projection)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Selects documents in a collection or view and returns a
diff --git a/source/reference/method/db.collection.findAndModify.txt b/source/reference/method/db.collection.findAndModify.txt
index b3246cce777..1be0e341a22 100644
--- a/source/reference/method/db.collection.findAndModify.txt
+++ b/source/reference/method/db.collection.findAndModify.txt
@@ -22,7 +22,7 @@ Definition
 .. method:: db.collection.findAndModify(document)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
 
diff --git a/source/reference/method/db.collection.findOne.txt b/source/reference/method/db.collection.findOne.txt
index c2bb452c7b8..090c0dfdab2 100644
--- a/source/reference/method/db.collection.findOne.txt
+++ b/source/reference/method/db.collection.findOne.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.findOne(query, projection)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Returns one document that satisfies the specified query criteria on
diff --git a/source/reference/method/db.collection.findOneAndDelete.txt b/source/reference/method/db.collection.findOneAndDelete.txt
index 9a3d6ee8e23..9dbe120d162 100644
--- a/source/reference/method/db.collection.findOneAndDelete.txt
+++ b/source/reference/method/db.collection.findOneAndDelete.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.findOneAndDelete( filter, options )
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.findOneAndReplace.txt b/source/reference/method/db.collection.findOneAndReplace.txt
index 37cc9eb1c3e..b36966bec6f 100644
--- a/source/reference/method/db.collection.findOneAndReplace.txt
+++ b/source/reference/method/db.collection.findOneAndReplace.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.findOneAndReplace( filter, replacement, options )
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.findOneAndUpdate.txt b/source/reference/method/db.collection.findOneAndUpdate.txt
index b2dae10d518..498ad2f6c47 100644
--- a/source/reference/method/db.collection.findOneAndUpdate.txt
+++ b/source/reference/method/db.collection.findOneAndUpdate.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.findOneAndUpdate( filter, update, options )
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.getIndexes.txt b/source/reference/method/db.collection.getIndexes.txt
index 337e2a32a39..ac7117628df 100644
--- a/source/reference/method/db.collection.getIndexes.txt
+++ b/source/reference/method/db.collection.getIndexes.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.getIndexes()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Returns an array that holds a list of documents that identify and
diff --git a/source/reference/method/db.collection.getPlanCache.txt b/source/reference/method/db.collection.getPlanCache.txt
index 5f2fc04a582..b053726deed 100644
--- a/source/reference/method/db.collection.getPlanCache.txt
+++ b/source/reference/method/db.collection.getPlanCache.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.getPlanCache()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Returns an interface to access the query plan cache for a
diff --git a/source/reference/method/db.collection.getShardDistribution.txt b/source/reference/method/db.collection.getShardDistribution.txt
index 3d3007ab305..b761e097295 100644
--- a/source/reference/method/db.collection.getShardDistribution.txt
+++ b/source/reference/method/db.collection.getShardDistribution.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.getShardDistribution()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Prints the data distribution statistics for a :term:`sharded
diff --git a/source/reference/method/db.collection.getShardVersion.txt b/source/reference/method/db.collection.getShardVersion.txt
index 46c23b147ee..ad13d694986 100644
--- a/source/reference/method/db.collection.getShardVersion.txt
+++ b/source/reference/method/db.collection.getShardVersion.txt
@@ -13,7 +13,7 @@ db.collection.getShardVersion()
 .. method:: db.collection.getShardVersion()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    This method returns information regarding the state of data in a
diff --git a/source/reference/method/db.collection.hideIndex.txt b/source/reference/method/db.collection.hideIndex.txt
index 742c0abe7fc..49568bb673c 100644
--- a/source/reference/method/db.collection.hideIndex.txt
+++ b/source/reference/method/db.collection.hideIndex.txt
@@ -17,7 +17,7 @@ Definition
 
    .. versionadded:: 4.4
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Hides an existing index from the query planner. An :doc:`index
    hidden from the query planner </core/index-hidden>` is not evaluated
diff --git a/source/reference/method/db.collection.initializeOrderedBulkOp.txt b/source/reference/method/db.collection.initializeOrderedBulkOp.txt
index d9554c1c12b..9d9e28a5b60 100644
--- a/source/reference/method/db.collection.initializeOrderedBulkOp.txt
+++ b/source/reference/method/db.collection.initializeOrderedBulkOp.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.initializeOrderedBulkOp()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Initializes and returns a new :method:`Bulk()` operations builder
diff --git a/source/reference/method/db.collection.initializeUnorderedBulkOp.txt b/source/reference/method/db.collection.initializeUnorderedBulkOp.txt
index 036b634bdef..96df47d1ba5 100644
--- a/source/reference/method/db.collection.initializeUnorderedBulkOp.txt
+++ b/source/reference/method/db.collection.initializeUnorderedBulkOp.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.initializeUnorderedBulkOp()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Initializes and returns a new :method:`Bulk()` operations builder
    for a collection. The builder constructs an *unordered* list of
diff --git a/source/reference/method/db.collection.insert.txt b/source/reference/method/db.collection.insert.txt
index 58ae3311481..501b3fecc03 100644
--- a/source/reference/method/db.collection.insert.txt
+++ b/source/reference/method/db.collection.insert.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.insert()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Inserts a document or documents into a collection.
diff --git a/source/reference/method/db.collection.insertMany.txt b/source/reference/method/db.collection.insertMany.txt
index 0d346bf36f9..e8ebafa4a1f 100644
--- a/source/reference/method/db.collection.insertMany.txt
+++ b/source/reference/method/db.collection.insertMany.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.insertMany()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.insertOne.txt b/source/reference/method/db.collection.insertOne.txt
index 2a2b29d643d..3cbbbb693c9 100644
--- a/source/reference/method/db.collection.insertOne.txt
+++ b/source/reference/method/db.collection.insertOne.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.insertOne()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.isCapped.txt b/source/reference/method/db.collection.isCapped.txt
index dbe7fe16ff9..2116bdeb49d 100644
--- a/source/reference/method/db.collection.isCapped.txt
+++ b/source/reference/method/db.collection.isCapped.txt
@@ -13,7 +13,7 @@ db.collection.isCapped()
 .. method:: db.collection.isCapped()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: Returns ``true`` if the collection is a :term:`capped
diff --git a/source/reference/method/db.collection.latencyStats.txt b/source/reference/method/db.collection.latencyStats.txt
index 3d0c57e275d..44c93eb3d0a 100644
--- a/source/reference/method/db.collection.latencyStats.txt
+++ b/source/reference/method/db.collection.latencyStats.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.latencyStats(options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :method:`db.collection.latencyStats()` returns latency
diff --git a/source/reference/method/db.collection.mapReduce.txt b/source/reference/method/db.collection.mapReduce.txt
index 9d0ab049637..6ea9d72b422 100644
--- a/source/reference/method/db.collection.mapReduce.txt
+++ b/source/reference/method/db.collection.mapReduce.txt
@@ -16,7 +16,7 @@ db.collection.mapReduce()
 
 .. method:: db.collection.mapReduce(map,reduce, { <options> })
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    The :method:`db.collection.mapReduce()` method provides a wrapper
    around the :dbcommand:`mapReduce` command.
diff --git a/source/reference/method/db.collection.reIndex.txt b/source/reference/method/db.collection.reIndex.txt
index cbeab60dceb..312a02e4696 100644
--- a/source/reference/method/db.collection.reIndex.txt
+++ b/source/reference/method/db.collection.reIndex.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.reIndex()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    The :method:`db.collection.reIndex()` drops all indexes on a
diff --git a/source/reference/method/db.collection.remove.txt b/source/reference/method/db.collection.remove.txt
index 953e93c14f9..6f7116a1c62 100644
--- a/source/reference/method/db.collection.remove.txt
+++ b/source/reference/method/db.collection.remove.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.remove()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Removes documents from a collection.
diff --git a/source/reference/method/db.collection.renameCollection.txt b/source/reference/method/db.collection.renameCollection.txt
index 8428c6476e2..165a9e779a8 100644
--- a/source/reference/method/db.collection.renameCollection.txt
+++ b/source/reference/method/db.collection.renameCollection.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.renameCollection(target, dropTarget)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Renames a collection. Provides a wrapper for the
diff --git a/source/reference/method/db.collection.replaceOne.txt b/source/reference/method/db.collection.replaceOne.txt
index 2697920f8be..26bb07a5324 100644
--- a/source/reference/method/db.collection.replaceOne.txt
+++ b/source/reference/method/db.collection.replaceOne.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.replaceOne(filter, replacement, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.save.txt b/source/reference/method/db.collection.save.txt
index 4aa24987e4e..f67e8128775 100644
--- a/source/reference/method/db.collection.save.txt
+++ b/source/reference/method/db.collection.save.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.save()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Updates an existing :doc:`document </core/document>` or inserts a
diff --git a/source/reference/method/db.collection.stats.txt b/source/reference/method/db.collection.stats.txt
index 38030294363..e9075cfa340 100644
--- a/source/reference/method/db.collection.stats.txt
+++ b/source/reference/method/db.collection.stats.txt
@@ -22,7 +22,7 @@ Definition
 .. method:: db.collection.stats(<option>)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    Returns statistics about the collection.
diff --git a/source/reference/method/db.collection.storageSize.txt b/source/reference/method/db.collection.storageSize.txt
index 58642c8b3cb..6c17fa23acd 100644
--- a/source/reference/method/db.collection.storageSize.txt
+++ b/source/reference/method/db.collection.storageSize.txt
@@ -13,7 +13,7 @@ db.collection.storageSize()
 .. method:: db.collection.storageSize()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: The total amount of storage allocated to this collection
diff --git a/source/reference/method/db.collection.totalIndexSize.txt b/source/reference/method/db.collection.totalIndexSize.txt
index cc2134e9bac..f6822b68660 100644
--- a/source/reference/method/db.collection.totalIndexSize.txt
+++ b/source/reference/method/db.collection.totalIndexSize.txt
@@ -13,7 +13,7 @@ db.collection.totalIndexSize()
 .. method:: db.collection.totalIndexSize()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: The total size of all indexes for the collection.  
diff --git a/source/reference/method/db.collection.totalSize.txt b/source/reference/method/db.collection.totalSize.txt
index 3f409aec255..c7ad4fe984c 100644
--- a/source/reference/method/db.collection.totalSize.txt
+++ b/source/reference/method/db.collection.totalSize.txt
@@ -13,7 +13,7 @@ db.collection.totalSize()
 .. method:: db.collection.totalSize()
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    :returns: The total size in bytes of the data in the collection plus
diff --git a/source/reference/method/db.collection.unhideIndex.txt b/source/reference/method/db.collection.unhideIndex.txt
index 29299465cf2..cab42f9b704 100644
--- a/source/reference/method/db.collection.unhideIndex.txt
+++ b/source/reference/method/db.collection.unhideIndex.txt
@@ -15,7 +15,7 @@ Definition
 
 .. method:: db.collection.unhideIndex()
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Unhides an existing index from the query planner. Once unhidden, the
    indexes are immediately available for use.
diff --git a/source/reference/method/db.collection.update.txt b/source/reference/method/db.collection.update.txt
index 2a66e936424..27fba97f683 100644
--- a/source/reference/method/db.collection.update.txt
+++ b/source/reference/method/db.collection.update.txt
@@ -17,7 +17,7 @@ Definition
 
 .. method:: db.collection.update(query, update, options)
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Modifies an existing document or documents in a collection. The
    method can modify specific fields of an existing document or documents
diff --git a/source/reference/method/db.collection.updateMany.txt b/source/reference/method/db.collection.updateMany.txt
index 8d8684c5fcd..941641c3277 100644
--- a/source/reference/method/db.collection.updateMany.txt
+++ b/source/reference/method/db.collection.updateMany.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.updateMany(filter, update, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.updateOne.txt b/source/reference/method/db.collection.updateOne.txt
index fbb7aa20113..aa8f20bcdd6 100644
--- a/source/reference/method/db.collection.updateOne.txt
+++ b/source/reference/method/db.collection.updateOne.txt
@@ -18,7 +18,7 @@ Definition
 .. method:: db.collection.updateOne(filter, update, options)
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    .. versionadded:: 3.2
diff --git a/source/reference/method/db.collection.validate.txt b/source/reference/method/db.collection.validate.txt
index 9e5d2838893..ffac18c76fc 100644
--- a/source/reference/method/db.collection.validate.txt
+++ b/source/reference/method/db.collection.validate.txt
@@ -15,7 +15,7 @@ Description
 
 .. method:: db.collection.validate(<documents>)
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
    Validates a collection. The method scans a collection data and
    indexes for correctness and returns the result. For details of the
diff --git a/source/reference/method/db.collection.watch.txt b/source/reference/method/db.collection.watch.txt
index ae9a0c29c67..7b836672713 100644
--- a/source/reference/method/db.collection.watch.txt
+++ b/source/reference/method/db.collection.watch.txt
@@ -16,7 +16,7 @@ Definition
 .. method:: db.collection.watch( pipeline, options )
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
+   .. include:: /includes/fact-mongosh-shell-method.rst
 
 
    *For replica sets and sharded clusters only*
diff --git a/source/reference/method/db.getMongo.txt b/source/reference/method/db.getMongo.txt
index 95d4d8b55e7..1fcdd2467a7 100644
--- a/source/reference/method/db.getMongo.txt
+++ b/source/reference/method/db.getMongo.txt
@@ -10,6 +10,8 @@ db.getMongo()
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-shell-method.rst
+
 .. method:: db.getMongo()
 
    :returns: The current database connection.
@@ -17,3 +19,10 @@ db.getMongo()
    :method:`db.getMongo()` runs when the shell initiates. Use this
    command to test that the :binary:`~bin.mongo` shell has a connection to
    the proper database instance.
+
+.. note::
+
+   The :binary:`~bin.mongo` shell has a sub-command,
+   ``db.getMongo().setSecondaryOk()`` which is not available in
+   ``mongosh``. Use :method:`Mongo.setReadPref()` instead.
+
diff --git a/source/reference/method/js-collection.txt b/source/reference/method/js-collection.txt
index d57e7913d4c..76bd79a4f1a 100644
--- a/source/reference/method/js-collection.txt
+++ b/source/reference/method/js-collection.txt
@@ -10,9 +10,9 @@ Collection Methods
    :depth: 1
    :class: singlecol
 
-.. note:: ``mongo`` Shell Methods
+.. note:: ``mongosh`` Methods
 
-   .. include:: /includes/fact-mongo-shell-method-toc.rst
+   .. include:: /includes/fact-mongosh-shell-method-toc.rst
 
 .. include:: /includes/extracts/methods-toc-explanation.rst
 
diff --git a/source/reference/method/js-cursor.txt b/source/reference/method/js-cursor.txt
index b432e3e1997..15a8f7391c0 100644
--- a/source/reference/method/js-cursor.txt
+++ b/source/reference/method/js-cursor.txt
@@ -10,9 +10,9 @@ Cursor Methods
    :depth: 1
    :class: singlecol
 
-.. note:: ``mongo`` Shell Methods
+.. note:: ``mongosh`` Methods
 
-   .. include:: /includes/fact-mongo-shell-method-toc.rst
+   .. include:: /includes/fact-mongosh-shell-method-toc.rst
 
 These methods modify the way that the underlying query is executed.