DOCSP-16533 extracted API links (#110)

* extracted API links

Author: kyuan-mongodb

source/faq.txt

@@ -197,7 +197,7 @@ The output of the above code snippet should look like this:
    {"_id": 1, "val": 1}
 
 For more information on the legacy classes and methods used in the above example,
-see the following API documentation pages:
+see the following API Documentation pages:
 
 - :java-docs:`Legacy API Javadoc Site <apidocs/mongodb-driver-legacy/index.html>`
 - :java-docs:`MongoClient <apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html>`
@@ -237,7 +237,7 @@ Here is an example showing how to use the legacy ``MongoClientOptions`` and
          :end-before: end current-api-mongoclientsettings-example
 
 For more information on the legacy classes and methods used in the above example,
-see the following API documentation pages:
+see the following API Documentation pages:
 
 - :java-docs:`Legacy API Javadoc Site <apidocs/mongodb-driver-legacy/index.html>`
 - :java-docs:`MongoClient <apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html>`

source/fundamentals/aggregation.txt

@@ -49,7 +49,7 @@ Aggregation operations have some :manual:`limitations </core/aggregation-pipelin
   of 16 megabytes.
 
 - Pipeline stages have a memory limit of 100 megabytes by default. If required, you may exceed this limit by using
-  the `allowDiskUse <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html#allowDiskUse(java.lang.Boolean)>`__
+  the :java-docs:`allowDiskUse <apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html#allowDiskUse(java.lang.Boolean)>`
   method.
 
   .. important:: ``$graphLookup`` exception
@@ -116,20 +116,17 @@ Basic Aggregation Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 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.
+``MongoCollection.aggregate()`` method.
 
 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.
+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
   ``categories`` array field contains the element ``Bakery``. The example uses
-  :java-docs:`Aggregates.match <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#match(org.bson.conversions.Bson)>`
-  to build the ``$match`` stage.
+  ``Aggregates.match`` to build the ``$match`` stage.
 
 - 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``.
@@ -152,6 +149,12 @@ The above aggregation should produce the following results:
    {"_id": 4, "count": 2}
    {"_id": 5, "count": 1}
 
+For more information about the methods and classes mentioned in this section,
+see the following API Documentation:
+
+- :java-docs:`MongoCollection.aggregate() <apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`
+- :java-docs:`Aggregates.match <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#match(org.bson.conversions.Bson)>`
+
 Explain Aggregation Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -191,18 +194,16 @@ following resources:
 
 - :manual:`Explain Output </reference/explain-results/>` Server Manual Entry
 - :manual:`Query Plans </core/query-plans/>` Server Manual Entry
-- :java-core-api:`ExplainVerbosity <com/mongodb/ExplainVerbosity>` API Documentation
+- :java-docs:`ExplainVerbosity <apidocs/mongodb-driver-core/com/mongodb/ExplainVerbosity>` API Documentation
 - :java-docs:`explain() <apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html#explain()>` API Documentation
 - :java-docs:`AggregateIterable <apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html>` API Documentation
 
 Aggregation Expression Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-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.
+The Java driver provides builders for accumulator expressions for use with 
+``$group``. You must declare all other expressions in JSON format or
+compatible document format.
 
 .. tip::
 
@@ -223,19 +224,16 @@ must declare all other expressions in JSON format or compatible document format.
       Document.parse("{ $arrayElemAt: ['$categories', 0] }")
 
 In the following example, the aggregation pipeline uses a
-`$project <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
-stage and various
-`Projections <https://mongodb.github.io/mongo-java-driver/4.2/apidocs/mongodb-driver-core/com/mongodb/client/model/Projections.html>`__
-to return the ``name`` field and the calculated field ``firstCategory`` whose value is the first element in the
-``categories`` field.
+``$project`` stage and various ``Projections`` to return the ``name``
+field and the calculated field ``firstCategory`` whose value is the
+first element in the ``categories`` field.
 
 .. literalinclude:: /includes/fundamentals/code-snippets/AggTour.java
    :language: java
    :dedent:
    :start-after: begin aggregation two
    :end-before: end aggregation two
 
-
 The above aggregation should produce the following results:
 
 .. code-block:: none
@@ -251,3 +249,11 @@ The above aggregation should produce the following results:
    {"name": "ZZZ Pasta Buffet", "firstCategory": "Pasta"}
    {"name": "XYZ Coffee Bar", "firstCategory": "Coffee"}
    {"name": "XYZ Bagels Restaurant", "firstCategory": "Bagels"}
+
+For more information about the methods and classes mentioned in this section,
+see the following API Documentation:
+
+- :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
+- :java-docs:`$group <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#group(TExpression,java.util.List)>`
+- :java-docs:`$project <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`
+- :java-docs:`Projections <apidocs/mongodb-driver-core/com/mongodb/client/model/Projections.html>`

source/fundamentals/auth.txt

@@ -146,7 +146,7 @@ mechanism:
 
       To specify the default authentication mechanism using the
       ``MongoCredential`` class, use the
-      :java-docs:`createScramSha256Credential() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createScramSha256Credential(java.lang.String,java.lang.String,char[])>`
+      :java-docs:`createScramSha256Credential() <apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createScramSha256Credential(java.lang.String,java.lang.String,char[])>`
       method. Your code to instantiate a ``MongoClient`` should look something like this:
 
       .. include:: /includes/fundamentals/code-snippets/auth-credentials-sha256.rst
@@ -198,7 +198,7 @@ mechanism:
 
       To specify the default authentication mechanism using the
       ``MongoCredential`` class, use the
-      :java-docs:`createScramSha1Credential() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createScramSha1Credential(java.lang.String,java.lang.String,char[])>`
+      :java-docs:`createScramSha1Credential() <apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createScramSha1Credential(java.lang.String,java.lang.String,char[])>`
       method. Your code to instantiate a ``MongoClient`` should look something like this:
 
       .. include:: /includes/fundamentals/code-snippets/auth-credentials-sha1.rst
@@ -291,7 +291,7 @@ mechanism:
         in the ``authMechanism`` parameter and your session token in the 
         ``authMechanismProperties`` parameter. Then, add it to your
         ``MongoClientSettings`` by calling the 
-        :java-docs:`applyConnectionString() </apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyConnectionString(com.mongodb.ConnectionString)>`
+        :java-docs:`applyConnectionString() <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#applyConnectionString(com.mongodb.ConnectionString)>`
         method as follows:
 
         .. include:: /includes/fundamentals/code-snippets/auth-credentials-aws-session.rst
@@ -300,7 +300,7 @@ mechanism:
 
         You can include your AWS session token in your ``MongoCredential``
         instance by specifying it in a call to the
-        :java-docs:`withMechanismProperty() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#withMechanismProperty(java.lang.String,T)>`
+        :java-docs:`withMechanismProperty() <apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#withMechanismProperty(java.lang.String,T)>`
         method as shown below:
 
         .. code-block:: java
@@ -359,11 +359,11 @@ mechanism:
 
       To specify the ``X.509`` authentication mechanism using the
       ``MongoCredential`` class, use the
-      :java-docs:`createMongoX509Credential() </apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createMongoX509Credential(java.lang.String)>`
+      :java-docs:`createMongoX509Credential() <apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#createMongoX509Credential(java.lang.String)>`
       method. Also, enable TLS by calling the
       :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>`
+      :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:
 
       .. include:: /includes/fundamentals/code-snippets/auth-credentials-x509.rst

source/fundamentals/builders/aggregates.txt

@@ -15,7 +15,7 @@ Aggregates Builders
 Overview
 --------
 
-This guide provides an overview of the :java-core-api:`Aggregates </com/mongodb/client/model/Aggregates>`
+This guide provides an overview of the :java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates>`
 class which provides static factory methods that build :manual:`aggregation pipeline
 stages </reference/operator/aggregation/>`.
 
@@ -220,7 +220,7 @@ for each distinct grouping.
 
 .. tip::
 
-   The driver includes the :java-core-api:`Accumulators <com/mongodb/client/model/Accumulators.html>`
+   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
    class with static factory methods for each of the supported accumulator.
 
 The following example creates a pipeline stage that groups documents by the value
@@ -471,7 +471,7 @@ into a bucket called "monster" for monstrously large screen sizes:
 
 .. tip::
 
-   The driver includes the :java-core-api:`Accumulators <com/mongodb/client/model/Accumulators.html>`
+   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
    class with static factory methods for each of the supported accumulator.
 
 .. literalinclude:: /includes/fundamentals/code-snippets/builders/AggBuilders.java
@@ -508,7 +508,7 @@ in a new field called ``avgPrice``:
 
 .. tip::
 
-   The driver includes the :java-core-api:`Accumulators <com/mongodb/client/model/Accumulators.html>`
+   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
    class with static factory methods for each of the supported accumulator:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/builders/AggBuilders.java