DOCSP-25472 collection interlinks v4.2 backport (#2137)

* DOCSP-25472 collection interlinks v4.4 (#2133)

* DOCSP-25472 collection interlinks v5.0 (#2128)

* DOCSP 25472 collection interlink ii (#1961)

* DOCSP-25472 db.collection.isCapped

* DOCSP-25472 db.collection.latencyStats

* DOCSP-25472 db.collection.reIndex

* DOCSP-25472 collection interlink

* DOCSP-25472 collection interlink

* DOCSP-25472 collection interlink

* DOCSP-25472 collection interlink

* DOCSP-25472 delete and update commands

* DOCSP-25472 delete and update commands

* DOCSP-25472 Adds mongosh interlink

* DOCSP-25472 Adds mongosh interlink

* DOCSP-25472 Fixes interlink to command

* DOCSP-25472 Updates command tip

* DOCSP-25472 Updates command tip

* DOCSP-25472 Updates command tip

* DOCSP-25472 Fixes build error

* DOCSP-25472 Self-review fixes

* DOCSP-25472 Self-review fixes

* DOCSP-25472 Self-review fixes

* DOCSP-25472 Fixes per Dave Cuthbert

* DOCSP-25472 Fixes per Dave Cuthbert

* DOCSP-25472 Fixes per Dave Cuthbert

* DOCSP-25472 Fixes per Dave Cuthbert

* DOCSP-25472 Fixes per Anna

* DOCSP-25472 Fixes per Anna

* DOCSP-25472 Fixes build issue

* DOCSP-25472 Fixes build

* DOCSP-25472 Fixes build

* DOCSP-25472 Fixes build

* DOCSP-25472 Fixes build

Author: kennethdyer

source/reference/command/aggregate.txt

@@ -20,8 +20,9 @@ Definition
    to process data from a collection or other source with a sequence of 
    stage-based manipulations.
 
-   .. |method| replace:: :method:`db.aggregate()` and 
-      :method:`db.collection.aggregate()` helper methods
+   .. |method| replace:: :method:`db.aggregate` and 
+      :method:`db.collection.aggregate` helper methods or with the
+      :method:`~db.collection.watch` helper method
    .. include:: /includes/fact-dbcommand-tip.rst
 
 Syntax
@@ -48,14 +49,6 @@ The command has following syntax:
      writeConcern: <document>
    }
 
-.. tip::
-
-   Rather than run the :dbcommand:`aggregate` command directly, most
-   users should use the :method:`db.collection.aggregate()` helper
-   provided in the :binary:`~bin.mongo` shell or the equivalent helper in
-   their driver. In 2.6 and later, the
-   :method:`db.collection.aggregate()` helper always returns a cursor.
-
 Command Fields
 ~~~~~~~~~~~~~~
 

source/reference/command/collMod.txt

@@ -16,8 +16,12 @@ Definition
 .. dbcommand:: collMod
 
    :dbcommand:`collMod` makes it possible to add options to a collection
-   or to modify view definitions. 
-   
+   or to modify view definitions.
+
+   .. |method| replace:: :method:`~db.collection.hideIndex` and
+      :method:`~db.collection.unhideIndex` helper methods
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    .. note::
 
       The view modified by this command does not refer to materialized
@@ -84,7 +88,6 @@ TTL Collections
    1.0 } for ns **namespace**`` if the specified ``keyPattern``
    does not exist.
 
-
 Document Validation
 ~~~~~~~~~~~~~~~~~~~
 

source/reference/command/collStats.txt

@@ -18,6 +18,18 @@ Definition
    The :dbcommand:`collStats` command returns a variety of storage statistics
    for a given collection.
 
+   .. |method| replace:: :method:`~db.collection.stats` helper method.  
+      Specific fields in the ``collStats`` output can be accessed using the
+      :method:`~db.collection.dataSize`,
+      :method:`~db.collection.estimatedDocumentCount`,
+      :method:`~db.collection.isCapped`,
+      :method:`~db.collection.latencyStats`,
+      :method:`~db.collection.storageSize`,
+      :method:`~db.collection.totalIndexSize`, and
+      :method:`~db.collection.totalSize`
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    .. |command| replace:: ``collStats``
 
    .. include:: /includes/fact-dbcommand.rst

source/reference/command/count.txt

@@ -18,6 +18,9 @@ Definition
    Counts the number of documents in a collection or a view. Returns a
    document that contains this count and as well as the command status.
 
+   .. |method| replace:: :method:`~db.collection.count`  helper method
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    .. note::
 
       MongoDB drivers compatible with the 4.0 features deprecate their
@@ -124,13 +127,6 @@ Definition
 
 
 
-
-   The :binary:`~bin.mongo` shell also provides the following wrapper methods for :dbcommand:`count`:
-   
-   - :method:`~cursor.count()`
-   - :method:`db.collection.estimatedDocumentCount()`
-   - :method:`db.collection.count()`
-
    .. important::
 
       - Avoid using the :dbcommand:`count` and its wrapper methods

source/reference/command/delete.txt

@@ -21,6 +21,14 @@ Definition
    collections </core/capped-collections>`. The remove methods provided
    by the MongoDB drivers use this command internally.
 
+   .. |method| replace:: :method:`~db.collection.deleteOne`,
+      :method:`~db.collection.deleteMany`, and
+      :method:`~db.collection.findOneAndDelete`
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip.rst
+
+   .. _delete-syntax:
+
    The :dbcommand:`delete` command has the following syntax:
 
    .. code-block:: javascript
@@ -136,10 +144,6 @@ Definition
         - Optional. 
 
           .. include:: /includes/extracts/collation-option.rst
-          
-          
-   
-
 
    :return:
 

source/reference/command/drop.txt

@@ -10,11 +10,17 @@ drop
    :depth: 1
    :class: singlecol
 
+Syntax
+------
+
 .. dbcommand:: drop
 
    The :dbcommand:`drop` command removes an entire collection from a
    database. The command has following syntax:
 
+   .. |method| replace:: :method:`~db.collection.drop` helper method
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    .. code-block:: javascript
 
       { drop: <collection_name>, writeConcern: <document>}

source/reference/command/reIndex.txt

@@ -12,6 +12,9 @@ reIndex
 
 .. dbcommand:: reIndex
 
+   .. |method| replace:: :method:`db.collection.reIndex` helper method
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    The :dbcommand:`reIndex` command drops all indexes on a
    collection and recreates them. This operation may be expensive for
    collections that have a large amount of data and/or a large number
@@ -44,15 +47,13 @@ reIndex
    .. list-table::
       :header-rows: 1
       :widths: 20 80
-
+    
       * - Field
         - Description
-
+    
       * - reIndex
         - The name of the collection to reindex.
-
-   The :binary:`~bin.mongo` shell provides a wrapper :method:`db.collection.reIndex()`.
-
+ 
 Behavior
 --------
 

source/reference/command/renameCollection.txt

@@ -19,6 +19,9 @@ Definition
    to :dbcommand:`renameCollection` in the form of a complete
    :term:`namespace` (``<database>.<collection>``).
 
+   .. |method| replace:: :method:`~db.collection.renameCollection` helper method
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    Issue the :dbcommand:`renameCollection` command against the
    :term:`admin database`.
 

source/reference/command/update.txt

@@ -20,16 +20,16 @@ Definition
 
    The :dbcommand:`update` command modifies documents in a collection.
    A single :dbcommand:`update` command can contain multiple update
-   statements. The update methods provided by the MongoDB drivers use
-   this command internally.
-
-   The :binary:`~bin.mongo` shell provides the following helper methods:
-
-   - :method:`db.collection.updateOne()`
-
-   - :method:`db.collection.updateMany()` 
-
-   - :method:`db.collection.update()`
+   statements. 
+
+   .. |method| replace:: :method:`~db.collection.updateOne`,
+      :method:`~db.collection.updateMany`, 
+      :method:`~db.collection.update`,
+      :method:`~db.collection.replaceOne`,
+      :method:`~db.collection.findOneAndReplace`, and
+      :method:`~db.collection.findOneAndUpdate` 
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip.rst
 
 Syntax
 ------

source/reference/command/validate.txt

@@ -18,6 +18,9 @@ Definition
    The :dbcommand:`validate` command checks a collection's data and
    indexes for correctness and returns the results.
 
+   .. |method| replace:: :method:`~db.collection.validate` helper method
+   .. include:: /includes/fact-dbcommand-tip.rst
+
    .. note::
 
       The :dbcommand:`validate` command does not support :doc:`views

source/reference/method/db.collection.count.txt

@@ -15,9 +15,8 @@ Definition
 
 .. method:: db.collection.count(query, options)
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :dbcommand:`count` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    .. note::
 

source/reference/method/db.collection.countDocuments.txt

@@ -15,15 +15,15 @@ Definition
 
 .. method:: db.collection.countDocuments(query, options)
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :pipeline:`$group` aggregation stage and 
+      the :group:`$sum` expression called by the :dbcommand:`aggregate`
+      command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    .. versionadded:: 4.0.3
 
    Returns the count of documents that match the query for a collection
-   or view. The method wraps the :pipeline:`$group` aggregation stage
-   with a :group:`$sum` expression to perform the count and is
+   or view.  This method is
    available for use in :doc:`/core/transactions`.
 
    .. code-block:: javascript

source/reference/method/db.collection.dataSize.txt

@@ -12,9 +12,9 @@ db.collection.dataSize()
 
 .. method:: db.collection.dataSize()
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :data:`~collStats.size` field returned by the
+      :dbcommand:`collStats` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    :returns: The size in bytes of the collection.
 

source/reference/method/db.collection.deleteMany.txt

@@ -15,9 +15,8 @@ Definition
 
 .. method:: db.collection.deleteMany()
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :dbcommand:`delete` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Removes all documents that match the ``filter`` from a collection.
 

source/reference/method/db.collection.deleteOne.txt

@@ -15,9 +15,8 @@ Definition
 
 .. method:: db.collection.deleteOne()
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :dbcommand:`delete` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Removes a single document from a collection.
 

source/reference/method/db.collection.drop.txt

@@ -17,9 +17,8 @@ Definition
 
 .. method:: db.collection.drop(<options>)
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :dbcommand:`drop` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Removes a collection or :doc:`view </core/views>` from the database.
    The method also removes any indexes associated with the dropped

source/reference/method/db.collection.estimatedDocumentCount.txt

@@ -15,14 +15,13 @@ Definition
 
 .. method:: db.collection.estimatedDocumentCount(options)
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :data:`~collStats.count` field returned by the
+      :dbcommand:`collStats` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    .. versionadded:: 4.0.3
 
-   Returns the count of all documents in a collection or view. The
-   method wraps the :dbcommand:`count` command.
+   Returns the count of all documents in a collection or view. 
 
    .. code-block:: javascript
 

source/reference/method/db.collection.findOneAndDelete.txt

@@ -15,11 +15,8 @@ Definition
 
 .. method:: db.collection.findOneAndDelete( filter, options )
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
-
-   .. versionadded:: 3.2
+   .. |dbcommand| replace:: :dbcommand:`delete` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Deletes a single document based on the ``filter`` and 
    ``sort`` criteria, returning the deleted document.

source/reference/method/db.collection.findOneAndReplace.txt

@@ -15,11 +15,8 @@ Definition
 
 .. method:: db.collection.findOneAndReplace( filter, replacement, options )
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
-
-   .. versionadded:: 3.2
+   .. |dbcommand| replace:: :dbcommand:`update` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Replaces a single document based on the specified :ref:`filter
    <findOneAndReplace-filter>`.

source/reference/method/db.collection.findOneAndUpdate.txt

@@ -18,11 +18,8 @@ Definition
 
 .. method:: db.collection.findOneAndUpdate( filter, update, options )
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
-
-   .. versionadded:: 3.2
+   .. |dbcommand| replace:: :dbcommand:`update` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    Updates a single document based on the ``filter`` and
    ``sort`` criteria.

source/reference/method/db.collection.isCapped.txt

@@ -12,9 +12,9 @@ db.collection.isCapped()
 
 .. method:: db.collection.isCapped()
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :data:`~collStats.capped` field returned by the 
+      :dbcommand:`collStats` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    :returns: Returns ``true`` if the collection is a :term:`capped
              collection`, otherwise returns ``false``.

source/reference/method/db.collection.latencyStats.txt

@@ -15,9 +15,9 @@ Definition
 
 .. method:: db.collection.latencyStats(options)
 
-
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: ``latencyStats`` field returned by the
+      :dbcommand:`collStats` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    :method:`db.collection.latencyStats()` returns latency
    statistics for a given collection. It is a wrapper around

source/reference/method/db.collection.mapReduce.txt

@@ -13,8 +13,8 @@ db.collection.mapReduce()
 .. method:: db.collection.mapReduce(map,reduce, {<out>,<query>,<sort>,<limit>,<finalize>,<scope>,<jsMode>,<verbose>})
 
 
-   .. include:: /includes/fact-mongo-shell-method.rst
-
+   .. |dbcommand| replace:: :dbcommand:`mapReduce` command
+   .. include:: /includes/fact-mongo-shell-method-alt.rst
 
    .. note::