DOCSP-26390 (#2123)

Author: jmd-mongo

source/administration/install-community.txt

@@ -18,15 +18,15 @@ These documents provide instructions to install MongoDB Community Edition.
 
 .. _`MongoDB Download Center`: https://www.mongodb.com/try/download/community?tck=docs_server
 
-:doc:`Install on Linux </administration/install-on-linux>`
+:ref:`Install on Linux <install-mdb-community-edition-linux>`
    Install MongoDB Community Edition and required dependencies on
    Linux.
 
-:doc:`Install on macOS </tutorial/install-mongodb-on-os-x>`
+:ref:`Install on macOS <install-mdb-community-macos>`
    Install MongoDB Community Edition on macOS systems from MongoDB
    archives.
 
-:doc:`Install on Windows </tutorial/install-mongodb-on-windows>`
+:ref:`Install on Windows <install-mdb-community-windows>`
    Install MongoDB Community Edition on Windows systems and
    optionally start MongoDB as a Windows service.
 

source/administration/install-enterprise-linux.txt

@@ -9,23 +9,23 @@ Install MongoDB Enterprise on Linux
 These documents provide instructions to install MongoDB Enterprise
 Edition for supported Linux systems.
 
-:doc:`Install on Red Hat </tutorial/install-mongodb-enterprise-on-red-hat>`
+:ref:`Install on Red Hat <install-mdb-enterprise-redhat-centos>`
    Install MongoDB Enterprise and required dependencies on Red Hat
    Enterprise or CentOS Systems using packages.
 
-:doc:`Install on Ubuntu </tutorial/install-mongodb-enterprise-on-ubuntu>`
+:ref:`Install on Ubuntu <install-mdb-enterprise-ubuntu>`
    Install MongoDB Enterprise and required dependencies on Ubuntu
    Linux Systems using packages.
 
-:doc:`Install on Debian </tutorial/install-mongodb-enterprise-on-debian>`
+:ref:`Install on Debian <install-mdb-enterprise-debian>`
    Install MongoDB Enterprise and required dependencies on Debian
    Linux Systems using packages.
 
-:doc:`Install on SUSE </tutorial/install-mongodb-enterprise-on-suse>`
+:ref:`Install on SUSE <install-mdb-enterprise-suse>`
    Install MongoDB Enterprise and required dependencies on SUSE
    Enterprise Linux.
 
-:doc:`Install on Amazon </tutorial/install-mongodb-enterprise-on-amazon>`
+:ref:`Install on Amazon <install-mdb-enterprise-amazon-linux>`
    Install MongoDB Enterprise and required dependencies on Amazon
    Linux AMI.
 

source/administration/install-enterprise.txt

@@ -23,18 +23,18 @@ Event Auditing.
 
    .. include:: /includes/fact-macos-snmp.rst
 
-:doc:`Install on Linux </administration/install-enterprise-linux>`
+:ref:`Install on Linux <install-enterprise-linux>`
    Install the official builds of MongoDB Enterprise on Linux-based
    systems.
 
-:doc:`Install on macOS </tutorial/install-mongodb-enterprise-on-os-x>`
+:ref:`Install on macOS <install-enterprise-macos>`
    Install the official build of MongoDB Enterprise on macOS
 
-:doc:`Install on Windows </tutorial/install-mongodb-enterprise-on-windows>`
+:ref:`Install on Windows <install-enterprise-windows>`
    Install MongoDB Enterprise on Windows using the ``.msi``
    installer.
 
-:doc:`Install with Docker </tutorial/install-mongodb-enterprise-with-docker>`
+:ref:`Install with Docker <install-mdb-enterprise-docker>`
    Install a MongoDB Enterprise Docker container.
 
 

source/administration/install-on-linux.txt

@@ -21,23 +21,23 @@ Linux distributions. These packages are the preferred way to run
 MongoDB. The following guides detail the installation process for these
 systems:
 
-:doc:`Install on Red Hat </tutorial/install-mongodb-on-red-hat>`
+:ref:`Install on Red Hat <install-mdb-community-redhat-centos>`
    Install MongoDB Community Edition on Red Hat Enterprise and
    related Linux systems using ``.rpm`` packages.
 
-:doc:`Install on Ubuntu </tutorial/install-mongodb-on-ubuntu>`
+:ref:`Install on Ubuntu <install-mdb-community-ubuntu>`
    Install MongoDB Community Edition on Ubuntu Linux systems using
    ``.deb`` packages.
 
-:doc:`Install on Debian </tutorial/install-mongodb-on-debian>`
+:ref:`Install on Debian <install-mdb-community-debian>`
    Install MongoDB Community Edition on Debian systems using ``.deb``
    packages.
 
-:doc:`Install on SUSE </tutorial/install-mongodb-on-suse>`
+:ref:`Install on SUSE <install-mdb-community-debian>`
    Install MongoDB Community Edition on SUSE Linux systems using
    ``.rpm`` packages.
 
-:doc:`Install on Amazon </tutorial/install-mongodb-on-amazon>`
+:ref:`Install on Amazon <install-mdb-community-amazon-linux>`
    Install MongoDB Community Edition on Amazon Linux AMI systems
    using ``.rpm`` packages.
 

source/applications/indexes.txt

@@ -1,3 +1,5 @@
+.. _indexing-strategies:
+
 ===================
 Indexing Strategies
 ===================

source/core/document.txt

@@ -94,7 +94,7 @@ Field Value Limit
 ~~~~~~~~~~~~~~~~~
 
 MongoDB 2.6 through MongoDB versions with :ref:`featureCompatibilityVersion <view-fcv>` (fCV) set to ``"4.0"`` or earlier
-   For :doc:`indexed collections </indexes>`, the values for the
+   For :ref:`indexed collections <indexes>`, the values for the
    indexed fields have a :limit:`Maximum Index Key Length <Index Key Limit>`. See
    :limit:`Maximum Index Key Length <Index Key Limit>` for details.
 

source/core/index-case-insensitive.txt

@@ -45,7 +45,7 @@ Behavior
 
 Using a case insensitive index does not affect
 the results of a query, but it can increase performance; see
-:doc:`Indexes</indexes>` for a detailed discussion of the costs and
+:ref:`Indexes <indexes>` for a detailed discussion of the costs and
 benefits of indexes.
 
 To use an index that specifies a collation, query and sort operations

source/faq/indexes.txt

@@ -13,8 +13,8 @@ FAQ: Indexes
    :class: singlecol
 
 This document addresses some common questions regarding MongoDB
-:doc:`indexes </indexes>`. For more information on indexes, see
-:doc:`/indexes`.
+indexes. For more information on indexes, see
+:ref:`indexes <indexes>`.
 
 How do I create an index?
 -------------------------
@@ -46,7 +46,7 @@ Index builds on replica sets have specific performance considerations
 and risks. See :ref:`index-operations-replicated-build` for more
 information. To minimize the impact of building an index on replica
 sets, including shard replica sets, use a rolling index build procedure
-as described in :doc:`/tutorial/build-indexes-on-replica-sets`. 
+as described in :ref:`index-build-on-replica-sets`. 
 
 To return information on currently running index creation operations,
 see :ref:`currentOp-index-creation`. To kill a running index creation
@@ -77,10 +77,10 @@ How do I determine which fields to index?
 
 A number of factors determine which fields to index, including
 :ref:`selectivity <index-selectivity>`, the support for multiple
-:term:`query shapes <query shape>`, and :doc:`size of the index
-</tutorial/ensure-indexes-fit-ram>`. For more information, see
+:term:`query shapes <query shape>`, and :ref:`size of the index
+<indexes-ensure-indexes-fit-ram>`. For more information, see
 :ref:`Operational Considerations for Indexes <data-model-indexes>` and
-:doc:`/applications/indexes`.
+:ref:`indexing-strategies`.
 
 How can I see the size of an index?
 -----------------------------------

source/includes/4.2-upgrade-replacements.rst

@@ -9,5 +9,5 @@
 .. |features| replace:: :ref:`features<4.2-compatibility-enabled>` 
 .. |downgradeversion| replace:: 4.0
 
-.. |installationdoc| replace:: :doc:`4.2 installation instructions </installation>`
+.. |installationdoc| replace:: :ref:`4.2 installation instructions <tutorial-installation>`
 

source/includes/4.4-upgrade-replacements.rst

@@ -10,7 +10,7 @@
 .. |features| replace:: :ref:`features<4.4-compatibility-enabled>` 
 .. |downgradeversion| replace:: 4.2
 
-.. |installationdoc| replace:: :doc:`4.4 installation instructions </installation>`
+.. |installationdoc| replace:: :ref:`4.4 installation instructions <tutorial-installation>`
 
 .. |newfcv| replace:: ``"4.4"``
-.. |oldfcv| replace:: ``"4.2"``
+.. |oldfcv| replace:: ``"4.2"``

source/includes/5.0-upgrade-replacements.rst

@@ -10,7 +10,7 @@
 .. |features| replace:: :ref:`features<5.0-compatibility-enabled>` 
 .. |downgradeversion| replace:: 4.4
 
-.. |installationdoc| replace:: :doc:`5.0 installation instructions </installation>`
+.. |installationdoc| replace:: :ref:`5.0 installation instructions <tutorial-installation>`
 
 .. |newfcv| replace:: ``"5.0"``
-.. |oldfcv| replace:: ``"4.4"``
+.. |oldfcv| replace:: ``"4.4"``

source/includes/6.0-upgrade-replacements.rst

@@ -10,7 +10,7 @@
 .. |features| replace:: :ref:`features<6.0-downgrade-considerations>` 
 .. |downgradeversion| replace:: 5.0
 
-.. |installationdoc| replace:: :doc:`6.0 installation instructions </installation>`
+.. |installationdoc| replace:: :ref:`6.0 installation instructions <tutorial-installation>`
 
 .. |newfcv| replace:: ``"6.0"``
 .. |oldfcv| replace:: ``"5.0"``

source/includes/extracts-enterprise.yaml

@@ -40,15 +40,11 @@ content: |
           manager, follow the package manager instructions for your
           operating system:
 
-          - :doc:`Red Hat Enterprise or CentOS </tutorial/install-mongodb-enterprise-on-red-hat>`
-
-          - :doc:`Ubuntu </tutorial/install-mongodb-enterprise-on-ubuntu>`
-
-          - :doc:`Debian </tutorial/install-mongodb-enterprise-on-debian>`
-
-          - :doc:`SUSE </tutorial/install-mongodb-enterprise-on-suse>`
-
-          - :doc:`Amazon Linux </tutorial/install-mongodb-enterprise-on-amazon>`
+          - :ref:`Red Hat Enterprise or CentOS <install-mdb-enterprise-redhat-centos>`
+          - :ref:`Ubuntu <install-mdb-enterprise-ubuntu>`
+          - :ref:`Debian <install-mdb-enterprise-debian>`
+          - :ref:`SUSE <install-mdb-enterprise-suse>`
+          - :ref:`Amazon Linux <install-mdb-enterprise-amazon>`
 
           During the installation, the package manager will remove the
           community packages; this will not affect the running
@@ -74,15 +70,11 @@ content: |
               directory and, if applicable, the existing configuration
               file.
 
-          - :doc:`Red Hat Enterprise or CentOS </tutorial/install-mongodb-enterprise-on-red-hat-tarball>`
-
-          - :doc:`Ubuntu </tutorial/install-mongodb-enterprise-on-ubuntu-tarball>`
-
-          - :doc:`Debian </tutorial/install-mongodb-enterprise-on-debian-tarball>`
-
-          - :doc:`SUSE </tutorial/install-mongodb-enterprise-on-suse-tarball>`
-
-          - :doc:`Amazon Linux </tutorial/install-mongodb-enterprise-on-amazon-tarball>`
+          - :ref:`Red Hat Enterprise or CentOS <install-mdb-enterprise-redhat-centos-tgz>`
+          - :ref:`Ubuntu <install-mdb-enterprise-ubuntu-tgz>`
+          - :ref:`Debian <install-mdb-enterprise-debian-tgz>`
+          - :ref:`SUSE <install-mdb-enterprise-suse-tgz>`
+          - :ref:`Amazon Linux <install-mdb-enterprise-amazon-tgz>`
 
       - id: windows
         name: Windows

source/includes/fact-check-amazon-linux-community.rst

@@ -7,5 +7,5 @@ following command on the command-line:
 
 The result should be **Amazon Linux** or **Amazon Linux AMI**. If using
 a different Linux distribution, please see the
-:doc:`install instructions for your platform
-</administration/install-on-linux>`.
+:ref:`install instructions for your platform 
+<install-mdb-community-edition-linux>`.

source/includes/fact-check-amazon-linux-enterprise.rst

@@ -7,5 +7,5 @@ following command on the command-line:
 
 The result should be **Amazon Linux** or **Amazon Linux AMI**. If using
 a different Linux distribution, please see the
-:doc:`install instructions for your platform
-</administration/install-enterprise-linux>`.
+:ref:`install instructions for your platform
+<install-enterprise-linux>`.

source/includes/fact-default-conf-file.rst

@@ -1,4 +1,4 @@
-- If you :doc:`installed MongoDB </installation>` with a package manager
+- If you :ref:`installed MongoDB <tutorial-installation>` with a package manager
   such as ``yum`` or ``apt`` on Linux or ``brew`` on macOS, or with the
   MSI installer on Windows, a default :doc:`configuration file
   </reference/configuration-options>` has been provided as part of your
@@ -27,7 +27,7 @@
        - MSI Installer
        - ``<install directory>\bin\mongod.cfg``
 
-- If you :doc:`installed MongoDB </installation>` via a downloaded
+- If you :ref:`installed MongoDB <tutorial-installation>` via a downloaded
   ``TGZ`` or ``ZIP`` file, you will need to create your own configuration
   file. The :ref:`basic example configuration <base-config>` is a good
   place to start.

source/includes/fact-download-dbtools-extra-server.rst

@@ -2,8 +2,7 @@ To install |tool-binary| as part of a MongoDB Enterprise Server
 installation:
 
 - Follow the instructions for your platform:
-  :doc:`Install MongoDB Enterprise Server
-  </administration/install-enterprise>`
+  :ref:`Install MongoDB Enterprise Server <install-mdb-enterprise>`
 
 - After completing the installation, |tool-binary| and the other 
   included tools are available in the same location as the Server.

source/includes/fact-index-intersection-vs-compound-indexes.rst

@@ -1,5 +1,5 @@
-Starting in version 2.6, MongoDB can use :doc:`index
-intersection </core/index-intersection>` to fulfill queries. The choice
-between creating compound indexes that support your queries or relying
-on index intersection depends on the specifics of your system. See
+MongoDB can use :ref:`index intersection <index-intersection>` to 
+fulfill queries. The choice between creating compound indexes that 
+support your queries or relying on index intersection depends on the 
+specifics of your system. See 
 :ref:`index-intersection-compound-indexes` for more details.

source/includes/steps-convert-replica-set-enable-sharding.yaml

@@ -30,8 +30,8 @@ title:
 stepnum: 3
 ref: enable-sharding-create-index
 pre: |
-    Before sharding a non-empty collection, create an :doc:`index on
-    the shard key </core/sharding-shard-key>`.
+    Before sharding a non-empty collection, create an :ref:`index on
+    the shard key <sharding-shard-key>`.
 action:
   language: sh
   code: |

source/reference/command/delete.txt

@@ -170,8 +170,8 @@ Each element of the ``deletes`` array contains the following fields:
      - Document or string
      - .. _deletes-array-hint:
 
-       Optional. A document or string that specifies the :doc:`index
-       </indexes>` to use to support the :ref:`query predicate
+       Optional. A document or string that specifies the :ref:`index
+       <indexes>` to use to support the :ref:`query predicate
        <deletes-array-q>`.
 
        The option can take an index specification document or the

source/reference/command/findAndModify.txt

@@ -191,7 +191,7 @@ The command takes the following fields:
    * - ``hint``
      - document or string
      - Optional. A document or string that specifies the
-       :doc:`index </indexes>` to use to support the ``query``.
+       :ref:`index <indexes>` to use to support the ``query``.
 
        The option can take an index specification document or the
        index name string.

source/reference/command/update.txt

@@ -221,8 +221,8 @@ Each document contains the following fields:
 
      - .. _update-command-hint:
 
-       Optional. A document or string that specifies the :doc:`index
-       </indexes>` to use to support the :ref:`query predicate
+       Optional. A document or string that specifies the :ref:`index
+       <indexes>` to use to support the :ref:`query predicate
        <update-command-q>`.
 
        The option can take an index specification document or the index

source/reference/configuration-options.txt

@@ -920,15 +920,15 @@ Core Options
       directory, or a systemd unit file registered with ``systemctl``. Only
       use the :setting:`processManagement.pidFilePath` option if you are not using one of these init
       systems. For more information, please see the respective
-      :doc:`Installation Guide </installation>` for your operating system.
+      :ref:`Installation Guide <tutorial-installation>` for your operating system.
 
    .. note:: macOS
 
 
       On macOS, PID file management is generally handled by ``brew``. Only use
       the :setting:`processManagement.pidFilePath` option if you are not using ``brew`` on your macOS system. 
       For more information, please see the respective
-      :doc:`Installation Guide </installation>` for your operating system.
+      Installation Guide for your operating system.
 
 .. setting:: processManagement.timeZoneInfo
 

source/reference/database-profiler.txt

@@ -295,7 +295,7 @@ operation.
    .. versionchanged:: 3.2.0
 
    Renamed from ``system.profile.nscanned``.
-   The number of :doc:`index </indexes>` keys that MongoDB scanned in
+   The number of :ref:`index <indexes>` keys that MongoDB scanned in
    order to carry out the operation.
 
    In general, if :data:`~system.profile.keysExamined` is much higher
@@ -415,7 +415,7 @@ operation.
 
    *Removed in 3.4.*
 
-   The number of :doc:`index </indexes>` keys the update changed in
+   The number of index keys the update changed in
    the operation. Changing an index key carries a small performance
    cost because the database must remove the old key and inserts a new
    key into the B-tree index.

source/reference/explain-results.txt

@@ -914,7 +914,7 @@ is ``0``.
 Index Intersection
 ------------------
 
-For an :doc:`index intersection plan </core/index-intersection>`, the
+For an :ref:`index intersection plan <index-intersection>`, the
 result will include either an ``AND_SORTED`` stage or an ``AND_HASH``
 stage with an :data:`explain.queryPlanner.winningPlan.inputStages` array that
 details the indexes; e.g.:

source/reference/glossary.txt

@@ -486,7 +486,7 @@ Glossary
       process. If you installed MongoDB via a package manager, an init
       script has been provided for your system as part of the
       installation. See the respective
-      :doc:`Installation Guide </installation>` for your operating
+      :ref:`Installation Guide <tutorial-installation>` for your operating
       system.
 
    init system
@@ -498,7 +498,7 @@ Glossary
       Linux tend to use the **systemd** init system, which uses the
       ``systemctl`` command, while older versions tend to use the
       **System V** init system, which uses the ``service`` command.
-      See the respective :doc:`Installation Guide </installation>` for
+      See the respective Installation Guide for
       your operating system.
 
    initial sync