switch to refs

Author: rachel-mack

source/connection/connection-options.txt

@@ -193,8 +193,8 @@ parameters of the connection URI to specify the behavior of the client.
 
    * - **authMechanism**
      - string
-     - Specifies the :doc:`authentication mechanism
-       </security/auth>` that the driver uses if a credential
+     - Specifies the :ref:`authentication mechanism
+       <java-authentication-mechanisms>` that the driver uses if a credential
        was supplied.
 
        | **Default**: By default, the client picks the most secure

source/crud/builders/aggregates.txt

@@ -1,3 +1,5 @@
+.. _aggregates-builders:
+
 ===================
 Aggregates Builders
 ===================
@@ -19,8 +21,6 @@ Aggregates Builders
 
    Atlas Vector Search </builders/vector-search>
 
-.. _aggregates-builders:
-
 Overview
 --------
 
@@ -90,7 +90,7 @@ Project
 
 Use the ``project()`` method to create a :manual:`$project </reference/operator/aggregation/project/>`
 pipeline stage that project specified document fields. Field projection
-in aggregation follows the same rules as :doc:`field projection in queries </crud/read-operations/project>`.
+in aggregation follows the same rules as :ref:`field projection in queries </java-fundamentals-project>`.
 
 .. tip::
 

source/crud/builders/filters.txt

@@ -1,26 +1,24 @@
+.. _filters-builders:
+
 ================
 Filters Builders
 ================
 
-
-
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
 
-.. _filters-builders:
-
 Overview 
 --------
 
 In this guide, you can learn how to use **builders** to specify
 **filters** for your queries in the MongoDB Java driver.
 
 Builders are classes provided by the MongoDB Java driver that help you
-construct :ref:`BSON <bson>` objects. To learn more, see our :doc:`guide
-on builders </builders/>`. 
+construct :ref:`BSON <bson>` objects. To learn more, see our :ref:`guide
+on builders <java-builders>`. 
 
 Filters are the operations MongoDB uses to limit your results to what
 you want to see. 

source/crud/builders/indexes.txt

@@ -1,22 +1,20 @@
+.. _indexes-builders:
+
 ================
 Indexes Builders
 ================
 
-
-
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
 
-.. _indexes-builders:
-
 Overview 
 --------
 
 In this guide, you can learn how to specify **indexes** using
-:doc:`builders </builders/>` in the MongoDB Java driver.
+:ref:`builders <java-builders>` in the MongoDB Java driver.
 The ``Indexes`` builder provides helper methods for constructing the
 following types of indexes:  
 
@@ -29,7 +27,7 @@ following types of indexes:
 
 Indexes store a subset of the collection’s data set. The index stores
 the value of a specific field or set of fields, ordered by the value of
-the field. See our guide on :doc:`Indexes </fundamentals/indexes>` for
+the field. See our guide on :ref:`Indexes <java-fundamentals-indexes>` for
 examples of queries covered by indexes. 
 
 The ``Indexes`` class provides static factory methods for all the MongoDB index types.

source/crud/builders/projections.txt

@@ -1,22 +1,20 @@
+.. _projections-builders:
+
 ====================
 Projections Builders
 ====================
 
-
-
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
 
-.. _projections-builders:
-
 Overview
 --------
 
 In this guide, you can learn how to specify **projections** using
-:doc:`builders </builders/>` in the MongoDB Java driver.
+:ref:`builders <java-builders>` in the MongoDB Java driver.
 
 MongoDB supports **field projection**, specifying which fields to include and exclude when returning results from a
 query. Projection in MongoDB follows some basic rules:

source/crud/builders/sort.txt

@@ -1,3 +1,5 @@
+.. _v:
+
 ==============
 Sorts Builders
 ==============
@@ -15,8 +17,6 @@ Sorts Builders
    :depth: 2
    :class: singlecol
 
-.. _sorts-builders:
-
 Overview
 --------
 
@@ -31,15 +31,15 @@ examples of sort criteria are:
 * Alphabetical order by first name 
 
 Builders are classes provided by the MongoDB Java driver that help you
-construct :ref:`BSON <bson>` objects. To learn more, see our :doc:`guide
-on builders </builders/>`. 
+construct :ref:`BSON <bson>` objects. To learn more, see our :ref:`guide
+on builders <java-builders>`. 
 
 You should read this guide if you would like to use builders to specify sort
 criteria for your queries.
 
 If you want to learn the fundamentals of sorting in the MongoDB Java
 driver, consider reading our
-:doc:`guide on sorting </crud/read-operations/sort/>`.
+:ref:`guide on sorting </java-fundamentals-sort>`.
 
 .. _sorts-builders-sort-sample:
 
@@ -63,7 +63,7 @@ criteria operators supported by MongoDB. These methods return a ``Bson`` object
 that you can pass to the  ``sort()`` method of a ``FindIterable`` instance or to 
 ``Aggregates.sort()``. If you want to learn more about the ``Aggregates``
 class, see our 
-:doc:`guide on the Aggregates builder </builders/aggregates>`.
+:ref:`guide on the Aggregates builder <aggregates-builders>`.
 
 For more information about the classes and interfaces in this section, see the
 following API Documentation:

source/crud/collations.txt

@@ -71,7 +71,7 @@ order as shown below:
 How to Specify Collations
 -------------------------
 
-MongoDB supports collations on most :doc:`CRUD operations </fundamentals/crud>`
+MongoDB supports collations on most :ref:`CRUD operations <java-crud-operations>`
 and aggregations. For a complete list of supported operations, see the
 :manual:`Operations that Support Collations </reference/collation/#operations-that-support-collation>`
 server manual page.

source/crud/compound-operations.txt

@@ -101,10 +101,10 @@ The output of the preceding code resembles the following:
    {"food": "pizza", "color": "green"}
 
 For more information about the ``Projections`` class, see our
-:doc:`guide on the Projections builder </builders/projections/>`.
+:ref:`guide on the Projections builder <projections-builders>`.
 
 For more information about the upsert operation, see our 
-:doc:`guide on upserts </crud/write-operations/upsert/>`.
+:ref:`guide on upserts <java-upsert>`.
 
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
@@ -187,7 +187,7 @@ The output of the preceding code resembles the following:
    {"_id": 2, "food": "pear", "color": "yellow"}
 
 For more information about the ``Sorts`` class, see our
-:doc:`guide on the Sorts builder </builders/sort/>`.
+:ref:`guide on the Sorts builder <sorts-builders>`.
 
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
@@ -318,10 +318,10 @@ instance:
    for the duration of your compound operation. 
 
 For information on the ``Updates`` class, see our
-:doc:`guide on the Updates builder </builders/updates/>`.
+:ref:`guide on the Updates builder <updates-builders>`.
 
 For more information of the ``Filters`` class, see our
-:doc:`guide on the Filters builder </builders/filters/>`.
+:ref:`guide on the Filters builder <filters-builders>`.
 
 For more information about the ``findOneAndUpdate()`` method, see 
 the API Documentation for the `MongoCollection class <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#findOneAndUpdate(org.bson.conversions.Bson,java.util.List,com.mongodb.client.model.FindOneAndUpdateOptions)>`__.

source/crud/gridfs.txt

@@ -263,8 +263,8 @@ see the following resources:
 
 - `GridFSFindIterable <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/gridfs/GridFSFindIterable.html>`__ API Documentation
 - `GridFSBucket.find() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/gridfs/GridFSBucket.html#find(org.bson.conversions.Bson)>`__ API Documentation
-- :doc:`Sort Results </crud/read-operations/sort>`
-- :doc:`Limit the Number of Returned Results </crud/read-operations/limit>`
+- :ref:`Sort Results <java-fundamentals-sort>`
+- :ref:`Limit the Number of Returned Results <java-fundamentals-limit>`
 
 .. _gridfs-download-files:
 

source/crud/query-document.txt

@@ -1,9 +1,9 @@
+.. _java-query:
+
 ===============
 Specify a Query
 ===============
 
-
-
 .. contents:: On this page
    :local:
    :backlinks: none