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

Author: kennethdyer

source/includes/fact-mongosh-shell-method-alt.rst

@@ -2,7 +2,9 @@
 
    This page documents a :binary:`~bin.mongosh` method. This is *not*
    the documentation for database commands or language-specific drivers,
-   such as Node.js. To use the database command, see the |dbcommand|.
+   such as Node.js. 
+   
+   For the database command, see the |dbcommand|.
 
    For MongoDB API drivers, refer to the language-specific
    :driver:`MongoDB driver documentation </>`.

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
 
 Syntax
@@ -49,13 +50,6 @@ The command has following syntax:
      let: <document> // Added in MongoDB 5.0
    }
 
-.. tip::
-
-   Rather than run the :dbcommand:`aggregate` command directly, most
-   users should use the :method:`db.collection.aggregate()` helper
-   provided in :binary:`~bin.mongosh` 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

@@ -18,6 +18,10 @@ Definition
    :dbcommand:`collMod` makes it possible to add options to a collection
    or to modify view definitions.
 
+   .. |method| replace:: :method:`~db.collection.hideIndex` and
+      :method:`~db.collection.unhideIndex` helper methods
+   .. include:: /includes/fact-dbcommand-tip
+
    .. note::
 
       The view modified by this command does not refer to materialized
@@ -98,11 +102,6 @@ Index Options
           Modifying the index option ``hidden`` resets the
           :pipeline:`$indexStats` for the index if the value changes.
 
-          .. seealso::
-
-             - :method:`db.collection.hideIndex()`
-             - :method:`db.collection.unhideIndex()`
-
           .. versionadded:: 4.4
 
    To change index options, specify either the key pattern or name of
@@ -126,7 +125,7 @@ Index Options
 
    .. seealso::
 
-      - :doc:`/core/index-hidden`
+      - :ref:`index-type-hidden`
       - :method:`db.collection.hideIndex()`
       - :method:`db.collection.unhideIndex()`
 

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
+
    .. |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
+
    .. note::
 
       MongoDB drivers compatible with the 4.0 features deprecate their
@@ -131,33 +134,6 @@ Definition
 
           .. versionadded:: 4.4
 
-
-
-   :binary:`~bin.mongosh` 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
-        without a query predicate (note:
-        :method:`db.collection.estimatedDocumentCount()` does not take
-        a query predicate) since without the query predicate, these
-        operations return results based on the collection's metadata,
-        which may result in an approximate count. In particular,
-
-        - On a sharded cluster, the resulting count will not correctly
-          filter out :term:`orphaned documents <orphaned document>`.
-
-        - :ref:`After an unclean shutdown <count-accuracy-shutdown>`,
-          the count may be incorrect.
-
-      - For counts based on collection metadata, see also 
-        :ref:`collStats pipeline stage with the count <collstat-count>`
-        option.
-
 Stable API Support
 ------------------
 

source/reference/command/delete.txt

@@ -23,6 +23,12 @@ Definition
 
    .. versionchanged:: 5.0
 
+   .. |method| replace:: :method:`~db.collection.deleteOne`,
+      :method:`~db.collection.deleteMany`, and
+      :method:`~db.collection.findOneAndDelete`
+      helper methods
+   .. include:: /includes/fact-dbcommand-tip
+
    .. _delete-syntax:
 
    The :dbcommand:`delete` command has the following syntax:
@@ -202,10 +208,6 @@ Definition
           For an example, see :ref:`ex-delete-command-hint`.
 
           .. versionadded:: 4.4
-          
-          
-   
-
 
    :returns:
 

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
+
    .. code-block:: javascript
 
       { drop: <collection_name>, writeConcern: <document>, comment: <any> }

source/reference/command/mapReduce.txt

@@ -22,6 +22,9 @@ Definition
    The :dbcommand:`mapReduce` command allows you to run
    :term:`map-reduce` aggregation operations over a collection. 
 
+   .. |method| replace:: :method:`~db.collection.mapReduce` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
 Syntax
 ------
 

source/reference/command/reIndex.txt

@@ -15,6 +15,9 @@ Definition
 
 .. dbcommand:: reIndex
 
+   .. |method| replace:: :method:`db.collection.reIndex` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
    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
@@ -37,15 +40,13 @@ Definition
    .. list-table::
       :header-rows: 1
       :widths: 20 80
-
+    
       * - Field
         - Description
-
+    
       * - reIndex
         - The name of the collection to reindex.
-
-   :binary:`~bin.mongosh` 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
+
    Issue the :dbcommand:`renameCollection` command against the
    :term:`admin database`.