DOCSP-17765 4.3 directive (#150)

* switched from 4.2 directive to a constant

Author: kyuan-mongodb

snooty.toml

@@ -8,6 +8,6 @@ toc_landing_pages = [
 ]
 
 [constants]
-version = 4.0
+version = 4.3
 package-name-org = "mongodb-org"
-pgp-version = "{+version+}"
+api = "https://mongodb.github.io/mongo-java-driver/{+version+}"

source/api-documentation.txt

@@ -8,8 +8,8 @@ API Documentation
    :titlesonly:
    :maxdepth: 1
 
-    BSON <https://mongodb.github.io/mongo-java-driver/4.3/apidocs/bson/index.html>
-    Core <https://mongodb.github.io/mongo-java-driver/4.3/apidocs/mongodb-driver-core/index.html>
-    Java Driver (modern API) <https://mongodb.github.io/mongo-java-driver/4.3/apidocs/mongodb-driver-sync/index.html>
-    Java Driver (legacy API) <https://mongodb.github.io/mongo-java-driver/4.3/apidocs/mongodb-driver-legacy/index.html>
+    BSON <{+api+}/apidocs/bson/index.html>
+    Core <{+api+}/apidocs/mongodb-driver-core/index.html>
+    Java Driver (modern API) <{+api+}/apidocs/mongodb-driver-sync/index.html>
+    Java Driver (legacy API) <{+api+}/apidocs/mongodb-driver-legacy/index.html>
 

source/faq.txt

@@ -59,7 +59,7 @@ tasks with the ``MongoClientSettings`` class:
 - :ref:`Get the Default Codec Registry <get-default-codec-registry-example>`
 
 For more information on the ``MongoClientSettings`` class, see the 
-:java-docs:`API Documentation for MongoClientSettings <apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`.
+`API Documentation for MongoClientSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__.
 
 How do I fix: "javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request"?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -223,15 +223,15 @@ The output of the preceding code snippet should look like this:
 For more information on the legacy classes and methods used in the preceding example,
 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>`
-- :java-docs:`DB <apidocs/mongodb-driver-legacy/com/mongodb/DB.html>`
-- :java-docs:`DBCollection <apidocs/mongodb-driver-legacy/com/mongodb/DBCollection.html>`
-- :java-docs:`DBObject <apidocs/mongodb-driver-core/com/mongodb/DBObject.html>`
-- :java-docs:`getDB() <apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html#getDB(java.lang.String)>`
-- :java-docs:`getCollection() <apidocs/mongodb-driver-legacy/com/mongodb/DB.html#getCollection(java.lang.String)>`
-- :java-docs:`find() <apidocs/mongodb-driver-legacy/com/mongodb/DBCollection.html#find()>`
-- :java-docs:`one() <apidocs/mongodb-driver-legacy/com/mongodb/DBCursor.html#one()>`
+- `Legacy API Javadoc Site <{+api+}/apidocs/mongodb-driver-legacy/index.html>`__
+- `MongoClient <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html>`__
+- `DB <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/DB.html>`__
+- `DBCollection <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/DBCollection.html>`__
+- `DBObject <{+api+}/apidocs/mongodb-driver-core/com/mongodb/DBObject.html>`__
+- `getDB() <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html#getDB(java.lang.String)>`__
+- `getCollection() <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/DB.html#getCollection(java.lang.String)>`__
+- `find() <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/DBCollection.html#find()>`__
+- `one() <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/DBCursor.html#one()>`__
 
 
 How do I use the legacy ``MongoClientOptions`` and ``MongoClientURI`` Classes?
@@ -263,10 +263,10 @@ Here is an example showing how to use the legacy ``MongoClientOptions`` and
 For more information on the legacy classes and methods used in the preceding example,
 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>`
-- :java-docs:`MongoClientOptions <apidocs/mongodb-driver-legacy/com/mongodb/MongoClientOptions.html>`
-- :java-docs:`MongoClientURI <apidocs/mongodb-driver-legacy/com/mongodb/MongoClientURI.html>`
+- `Legacy API Javadoc Site <{+api+}/apidocs/mongodb-driver-legacy/index.html>`__
+- `MongoClient <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/MongoClient.html>`__
+- `MongoClientOptions <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/MongoClientOptions.html>`__
+- `MongoClientURI <{+api+}/apidocs/mongodb-driver-legacy/com/mongodb/MongoClientURI.html>`__
 
 Support
 -------

source/fundamentals/aggregation.txt

@@ -51,7 +51,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 :java-docs:`allowDiskUse <apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html#allowDiskUse(java.lang.Boolean)>`
+  the `allowDiskUse <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html#allowDiskUse(java.lang.Boolean)>`__
   method.
 
   .. important:: ``$graphLookup`` exception
@@ -121,7 +121,7 @@ To perform an aggregation, pass a list of aggregation stages to the
 ``MongoCollection.aggregate()`` method.
 
 The Java driver provides the 
-:java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html>`
+`Aggregates <{+api+}/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:
@@ -154,8 +154,8 @@ The preceding aggregation should produce the following results:
 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)>`
+- `MongoCollection.aggregate() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#aggregate(java.util.List)>`__
+- `Aggregates.match <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#match(org.bson.conversions.Bson)>`__
 
 Explain Aggregation Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -196,9 +196,9 @@ following resources:
 
 - :manual:`Explain Output </reference/explain-results/>` Server Manual Entry
 - :manual:`Query Plans </core/query-plans/>` Server Manual Entry
-- :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
+- `ExplainVerbosity <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ExplainVerbosity>`__ API Documentation
+- `explain() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html#explain()>`__ API Documentation
+- `AggregateIterable <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/AggregateIterable.html>`__ API Documentation
 
 Aggregation Expression Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -255,7 +255,7 @@ The preceding aggregation should produce the following results:
 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>`
+- `Accumulators <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`__
+- `$group <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#group(TExpression,java.util.List)>`__
+- `$project <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates.html#project(org.bson.conversions.Bson)>`__
+- `Projections <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Projections.html>`__

source/fundamentals/auth.txt

@@ -148,7 +148,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[])>`
+      `createScramSha256Credential() <{+api+}/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
@@ -200,7 +200,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[])>`
+      `createScramSha1Credential() <{+api+}/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
@@ -278,7 +278,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)>`
+      `createAwsCredential() <{+api+}/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
@@ -293,7 +293,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)>`
+        `applyConnectionString() <{+api+}/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
@@ -302,7 +302,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)>`
+        `withMechanismProperty() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html#withMechanismProperty(java.lang.String,T)>`__
         method as shown below:
 
         .. code-block:: java
@@ -361,11 +361,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)>`
+      `createMongoX509Credential() <{+api+}/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)>`
+      `applyToSslSettings() <{+api+}/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>`
+      `SslSettings.Builder <{+api+}/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
 --------
 
-In this guide, you can learn how to use the :java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates>`
+In this guide, you can learn how to use the `Aggregates <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates>`__
 class which provides static factory methods that build :manual:`aggregation pipeline
 stages </meta/aggregation-quick-reference/#stages>` in the MongoDB Java driver.
 
@@ -220,7 +220,7 @@ for each distinct grouping.
 
 .. tip::
 
-   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
+   The driver includes the `Accumulators <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`__
    class with static factory methods for each of the supported accumulators.
 
 The following example creates a pipeline stage that groups documents by the value
@@ -472,7 +472,7 @@ into a bucket called "monster" for monstrously large screen sizes:
 
 .. tip::
 
-   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
+   The driver includes the `Accumulators <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`__
    class with static factory methods for each of the supported accumulators.
 
 .. literalinclude:: /includes/fundamentals/code-snippets/builders/AggBuilders.java
@@ -509,7 +509,7 @@ in a new field called ``avgPrice``:
 
 .. tip::
 
-   The driver includes the :java-docs:`Accumulators <apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`
+   The driver includes the `Accumulators <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/Accumulators.html>`__
    class with static factory methods for each of the supported accumulators.
 
 .. literalinclude:: /includes/fundamentals/code-snippets/builders/AggBuilders.java
@@ -547,7 +547,7 @@ on a specified span of documents in a collection.
 
 .. tip:: Window Functions
 
-   The driver includes the `WindowedComputations <https://mongodb.github.io/mongo-java-driver/4.3/apidocs/mongodb-driver-core/com/mongodb/client/model/WindowedComputations.html>`__
+   The driver includes the `WindowedComputations <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/WindowedComputations.html>`__
    class with static factory methods for each of the supported window operators.
 
 The following example creates a pipeline stage that computes the