DOCSP-26476 user-defined roles - writes doc directive replacements (#2298)

Author: jmd-mongo

source/core/workload-isolation.txt

@@ -74,5 +74,6 @@ documentation in the MongoDB Manual:
 
    Before adding workload isolation features to your application
    and MongoDB deployment, become familiar with all documentation of
-   :doc:`replication </replication>` and :ref:`sharding <sharding-background>`.
+   :ref:`replication <replication>`, and :ref:`sharding 
+   <sharding-background>`.
 

source/includes/steps-authorization-create-users.yaml

@@ -67,8 +67,8 @@ pre: |
 
   After authenticating as the user administrator, use the
   :method:`db.createUser()` method to create additional users. You can assign
-  any :doc:`built-in roles </reference/built-in-roles>` or
-  :doc:`user-defined roles </core/security-user-defined-roles>` to the
+  any :ref:`built-in roles <built-in-roles>` or
+  :ref:`user-defined roles <user-defined-roles>` to the
   users.
 
 action:

source/reference/aggregation-variables.txt

@@ -1,3 +1,5 @@
+.. _aggregation-variables:
+
 ====================================
 Variables in Aggregation Expressions
 ====================================

source/reference/command/nav-crud.txt

@@ -1,3 +1,5 @@
+.. _query-and-write-commands:
+
 ==================================
 Query and Write Operation Commands
 ==================================

source/reference/limits.txt

@@ -451,7 +451,7 @@ Operations
 
 .. limit:: Write Command Batch Limit Size
 
-   ``100,000`` :doc:`writes </reference/command/nav-crud>` are
+   ``100,000`` :ref:`writes <query-and-write-commands>` are
    allowed in a single batch operation, defined by a single request to
    the server.
 

source/reference/operator/aggregation/let.txt

@@ -15,7 +15,7 @@ Definition
 
 .. expression:: $let
 
-   Binds :doc:`variables </reference/aggregation-variables>` for use in
+   Binds :ref:`variables <aggregation-variables>` for use in
    the specified expression, and returns the result of the expression.
 
    The :expression:`$let` expression has the following syntax:

source/reference/operator/aggregation/reduce.txt

@@ -76,7 +76,7 @@ Definition
           - ``value`` is the :doc:`variable </reference/aggregation-variables>`
             that represents the cumulative value of the expression.
 
-          - ``this`` is the :doc:`variable</reference/aggregation-variables>`
+          - ``this`` is the :ref:`variable <aggregation-variables>`
             that refers to the element being processed.
 
 

source/release-notes/4.2-compatibility.txt

@@ -816,6 +816,6 @@ features include:
 
 - .. include:: /includes/extracts/4.2-changes-type-0.rst
 
-- MongoDB 4.2 adds :doc:`wildcard indexes </core/index-wildcard>` to 
+- MongoDB 4.2 adds :ref:`wildcard indexes <wildcard-index-core>` to 
   support workloads where users query against custom fields or a large 
   variety of fields in a collection.