Docsp 16488 broken links (#99)

Author: biniona-mongodb

source/fundamentals/aggregation.txt

@@ -43,9 +43,9 @@ Using ``aggregation`` operations, you can:
 - summarize data
 - group values
 
-Aggregation operations have some :manual:`limitations <core/aggregation-pipeline-limits/>` you must keep in mind:
+Aggregation operations have some :manual:`limitations </core/aggregation-pipeline-limits/>` you must keep in mind:
 
-- Returned documents must not violate the :manual:`BSON document size limit </reference/limits/#BSON-Document-Size>`
+- Returned documents must not violate the :manual:`BSON document size limit </reference/limits/#mongodb-limit-BSON-Document-Size>`
   of 16 megabytes.
 
 - Pipeline stages have a memory limit of 100 megabytes by default. If required, you may exceed this limit by using
@@ -54,7 +54,7 @@ Aggregation operations have some :manual:`limitations <core/aggregation-pipeline
 
   .. important:: ``$graphLookup`` exception
 
-     The :manual:`$graphLookup </operator/aggregation/graphLookup/>` stage has a strict memory limit of 100 megabytes
+     The :manual:`$graphLookup </reference/operator/aggregation/graphLookup/>` stage has a strict memory limit of 100 megabytes
      and will ignore ``allowDiskUse``.
 
 Useful References
@@ -115,21 +115,23 @@ Insert the Data
 Basic Aggregation Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To perform an aggregation, pass a list of aggregation stages to the `MongoCollection.aggregate() <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/MongoCollection.html#aggregate(com.mongodb.client.ClientSession,java.util.List,java.lang.Class)>`__
+To perform an aggregation, pass a list of aggregation stages to the 
+:java-docs:`MongoCollection.aggregate() <apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`
 method.
 
-The Java driver provides the `Aggregates <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html>`__
+The Java driver provides the 
+:java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html>`
 helper class that
 contains builders for aggregation stages.
 
 In the following example, the aggregation pipeline:
 
-- Uses a :manual:`$match <reference/operator/aggregation/match/>` stage to filter for documents whose
+- Uses a :manual:`$match </reference/operator/aggregation/match/>` stage to filter for documents whose
   ``categories`` array field contains the element ``Bakery``. The example uses
-  `Aggregates.match <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#match(org.bson.conversions.Bson)>`__
+  :java-docs:`Aggregates.match <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#match(org.bson.conversions.Bson)>`
   to build the ``$match`` stage.
 
-- Uses a :manual:`$group <reference/operator/aggregation/group/>` stage to group the matching documents by the ``stars``
+- Uses a :manual:`$group </reference/operator/aggregation/group/>` stage to group the matching documents by the ``stars``
   field, accumulating a count of documents for each distinct value of ``stars``.
 
 .. note::
@@ -196,8 +198,10 @@ following resources:
 Aggregation Expression Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The Java driver provides builders for :java-sync-api:`accumulator expressions<com/mongodb/client/model/Accumulators.html>`
-for use with :java-sync-api:`$group <com/mongodb/client/model/Aggregates.html#group(TExpression,java.util.List)>`. You
+The Java driver provides builders for
+:java-docs:`accumulator expressions <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
+for use with 
+:java-docs:`$group <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#group(TExpression,java.util.List)>`. You
 must declare all other expressions in JSON format or compatible document format.
 
 .. tip::

source/fundamentals/auth.txt

@@ -273,7 +273,7 @@ mechanism:
 
       To specify the ``MONGODB-AWS`` authentication mechanism using the
       ``MongoCredential`` class, use the
-      :java-docs:`createAwsCredential() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createAwsCredential(java.lang.String,char%5B%5D)>`
+      :java-docs:`createAwsCredential() <apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createAwsCredential(java.lang.String,char%5B%5D)>`
       method. Your code to instantiate a ``MongoClient`` should look something like this:
 
       .. include:: /includes/fundamentals/code-snippets/auth-credentials-aws.rst
@@ -358,7 +358,7 @@ mechanism:
       ``MongoCredential`` class, use the
       :java-docs:`createMongoX509Credential() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createMongoX509Credential(java.lang.String)>`
       method. Also, enable TLS by calling the
-      :java-sync-api:`applyToSslSettings() <com/mongodb/MongoClientSettings.Builder.html#applyToSslSettings(com.mongodb.Block)>`
+      :java-docs:`applyToSslSettings() <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyToSslSettings(com.mongodb.Block)>`
       method and setting the ``enabled`` property to ``true`` in the
       :java-docs:`SslSettings.Builder </apidocs/mongodb-driver-core/com/mongodb/connection/SslSettings.Builder.html>`
       block. Your code to instantiate a ``MongoClient`` should look something like this:

source/fundamentals/builders/filters.txt

@@ -462,7 +462,7 @@ The geospatial operator methods include:
 
 The following example creates a filter that matches documents in which
 the ``point`` field contains a GeoJSON geometry that falls within
-the given :manual:`Polygon </reference/geojson/index.html#polygon>` 
+the given :manual:`Polygon </reference/geojson/#polygon>` 
 in the ``geo_points`` collection:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/Filters.java

source/fundamentals/builders/projections.txt

@@ -249,7 +249,7 @@ The following code shows the output from this projection:
 
 
 When you've specified matching criteria in the **query** portion of your operation, use the ``elemMatch(String)`` method
-variant to specify a :manual:`positional projection </reference/operator/projection/positional/#projection/>` to include
+variant to specify a :manual:`positional projection </reference/operator/projection/positional/#sorts-and-the-positional-operator>` to include
 the first element of an array. Only documents that match the query filter will be retrieved.
 
 .. warning::
@@ -350,7 +350,7 @@ Project a Text Score
 ~~~~~~~~~~~~~~~~~~~~
 
 Use the ``metaTextScore()`` method to specify a projection of
-:manual:`score of a text query </reference/operator/query/text/#return-the-text-search-score/>`
+:manual:`score of a text query </reference/operator/query/text/#text-score>`
 
 The following example projects the text score as the value of the ``score`` field:
 

source/fundamentals/builders/updates.txt

@@ -283,7 +283,7 @@ Current Date
 ~~~~~~~~~~~~
 Use the :java-core-api:`currentDate() <com/mongodb/client/model/Updates.html#currentDate(java.lang.String)>`
 method to assign the value of a field in an update operation to the
-current date as a :manual:`date </reference/bson-types/#document-bson-type-date>`.
+current date as a :manual:`date </reference/bson-types/#date>`.
 
 The following example sets the value of the ``lastModified`` field to
 the current date as a BSON date:
@@ -311,7 +311,7 @@ Current Timestamp
 ~~~~~~~~~~~~~~~~~
 Use the :java-core-api:`currentTimestamp() <com/mongodb/client/model/Updates.html#currentTimestamp(java.lang.String)>`
 method to assign the value of a field in an update operation to the
-current date as a :manual:`timestamp </reference/bson-types/#document-bson-type-timestamp>`. 
+current date as a :manual:`timestamp </reference/bson-types/#timestamps>`. 
 
 The following example sets the value of the ``lastModified`` field to
 the current date as a BSON timestamp:

source/fundamentals/connection.txt

@@ -57,17 +57,16 @@ connected. The following example shows each part of the connection URI:
    :alt: Connection String parts figure
 
 In this example, for the protocol, we use ``mongodb+srv`` which specifies the
-:manual:`DNS Seedlist Connection Format
-</reference/connection-string/#dns-seedlist-connection-format>`. This indicates
-that the hostname following it corresponds to the DNS SRV record of your
+:manual:`DNS Seedlist Connection Format </reference/connection-string/#std-label-connections-dns-seedlist>`. 
+This indicates that the hostname following it corresponds to the DNS SRV record of your
 MongoDB instance or deployment. If your instance or deployment does not have a
 DNS SRV record, use ``mongodb`` to specify the :manual:`Standard Connection
 Format </reference/connection-string/#standard-connection-string-format>`.
 
 .. note::
 
    If your deployment is on MongoDB Atlas, follow the
-   :atlas:`Atlas driver connection guide <driver-connection?jmp=docs_driver_java>`
+   :atlas:`Atlas driver connection guide </driver-connection?jmp=docs_driver_java>`
    to retrieve your connection string.
 
 The next part of the connection string contains your username and password
@@ -132,9 +131,8 @@ replica set named "myRs".
 
 .. note::
 
-   The :manual:`replicaSet option
-   </reference/connection-string/#urioption.replicaSet>` is not
-   necessary to connect to a replica set, since the driver automatically
+   The :manual:`replicaSet option </reference/connection-string/#replica-set-option>`
+   is not necessary to connect to a replica set, since the driver automatically
    detects and handles multiple hosts in the connection string as a
    replica set.
 
@@ -199,11 +197,12 @@ using a method in the ``MongoClientSettings.Builder`` class.
    .. tab:: MongoClientSettings
       :tabid: mongoclientsettings
 
-      To enable compression with :java-sync-api:`MongoClientSettings
-      <com/mongodb/MongoClientSettings.html>`, pass the
-      :java-sync-api:`compressorList()
-      <com/mongodb/MongoClientSettings.Builder.html#compressorList(java.util.List)>`
-      builder method a list of :java-sync-api:`MongoCompressor <com/mongodb/MongoCompressor.html>`
+      To enable compression with 
+      :java-docs:`MongoClientSettings <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`, 
+      pass the
+      :java-docs:`compressorList() <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#compressorList(java.util.List)>`
+      builder method a list of 
+      :java-docs:`MongoCompressor <apidocs/mongodb-driver-core/com/mongodb/MongoCompressor.html>`
       instances. You can specify one or more compression algorithms in the list:
 
       .. code-block:: java
@@ -346,20 +345,19 @@ parameters of the connection URI to specify the behavior of the client.
      - integer
      - Specifies a time limit, in milliseconds, for the write concern. For
        more information, see the server documentation for the
-       :manual:`wtimeoutMS option
-       </reference/connection-string/#urioption.wtimeoutMS>`.
+       :manual:`wtimeoutMS option </reference/connection-string/#write-concern-options>`.
 
    * - **readPreference**
      - string
      - Specifies the read preference. For more information on values, see
-       the server documentation for the :manual:`readPreference option
-       </reference/connection-string/#urioption.readPreference>`.
+       the server documentation for the 
+       :manual:`readPreference option </reference/connection-string/#urioption.readPreference>`.
 
    * - **readPreferenceTags**
      - string
      - Specifies the read preference tags. For more information on values, see
-       the server documentation for the :manual:`readPreferenceTags option
-       </reference/connection-string/#urioption.readPreferenceTags>`.
+       the server documentation for the
+       :manual:`readPreferenceTags option </reference/connection-string/#urioption.readPreferenceTags>`.
 
    * - **maxStalenessSeconds**
      - integer
@@ -369,8 +367,7 @@ parameters of the connection URI to specify the behavior of the client.
        should be no staleness check for secondaries. The minimum value is
        either 90 seconds or the heartbeat frequency plus 10 seconds, whichever
        is greater. For more information, see the server documentation for the
-       :manual:`maxStalenessSeconds option
-       </reference/connection-string/#urioption.maxStalenessSeconds>`.
+       :manual:`maxStalenessSeconds option </reference/connection-string/#urioption.maxStalenessSeconds>`.
 
    * - **authMechanism**
      - string
@@ -431,12 +428,13 @@ parameters of the connection URI to specify the behavior of the client.
      - string
      - Specifies the UUID representation to use for read and write
        operations. For more information, see the the driver documentation
-       for the :java-sync-api:`MongoClientSettings.getUuidRepresentation() method
-       <com/mongodb/MongoClientSettings.html#getUuidRepresentation()>`.
+       for the 
+       :java-docs:`MongoClientSettings.getUuidRepresentation() method <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html#getUuidRepresentation()>`.
 
    * - **directConnection**
      - boolean
      - Specifies that the driver must connect to the host directly.
 
-For a complete list of options, see the :java-sync-api:`ConnectionString
-<com/mongodb/ConnectionString.html>` API reference page.
+For a complete list of options, see the 
+:java-docs:`ConnectionString <apidocs/mongodb-driver-core/com/mongodb/ConnectionString.html>`
+API reference page.

source/fundamentals/connection/tls.txt

@@ -50,8 +50,8 @@ using a method in the ``MongoClientSettings.Builder`` class.
       :tabid: mongoclientsettings
 
       To configure your ``MongoClient``'s TLS/SSL connection options using the
-      ``MongoClientSettings.Builder`` class, call the :java-sync-api:`applyToSslSettings()
-      <com/mongodb/MongoClientSettings.Builder.html#applyToSslSettings(com.mongodb.Block)>`
+      ``MongoClientSettings.Builder`` class, call the 
+      :java-docs:`applyToSslSettings() <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyToSslSettings(com.mongodb.Block)>`
       method. Set the ``enabled`` property to ``true`` in the ``SslSettings.Builder``
       block to enable TLS/SSL:
 

source/fundamentals/crud/read-operations/geo.txt

@@ -40,7 +40,7 @@ Here is the location of MongoDB headquarters in GeoJSON:
    }
 
 For definitive information on GeoJSON, see the
-:rfc:`official IETF specification <7946>`.
+`official IETF specification <https://datatracker.ietf.org/doc/html/rfc7946>`__.
 
 .. external resource
 

source/fundamentals/crud/read-operations/sort.txt

@@ -304,7 +304,7 @@ You can specify the order of the results of a
 :manual:`text search </text-search/>` by how closely the string values of
 each result's fields specified by the collection's text index match your search
 string. The text search assigns a numerical
-:manual:`text score </reference/operator/aggregation/meta/#exp._S_meta>` to
+:manual:`text score </reference/operator/aggregation/meta/>` to
 indicate how closely each result matches the search string. Use the
 ``Sorts.metaTextScore()`` static factory method to build your sort criteria to
 sort by the text score.

source/fundamentals/crud/write-operations/insert.txt

@@ -161,7 +161,7 @@ Your output should look something like this:
 For additional information on the classes and methods mentioned in this
 section, see the following resources: 
 
-- :java-sync-api:`API Documentation on insertMany() <com/mongodb/client/MongoCollection.html#insertMany>`
+- :java-docs:`API Documentation on insertMany() <apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#insertMany(java.util.List)>`
 - :java-docs:`API Documentation on InsertManyResult <apidocs/mongodb-driver-core/com/mongodb/client/result/InsertManyResult.html>`
 - :manual:`Manual Explanation on insertMany() </reference/method/db.collection.insertMany/>`
 - :doc:`Runnable Insert Multiple Documents Example </usage-examples/insertMany>`