DOCSP-48687 - Standardize API source constants (#89)

(cherry picked from commit a388439)

Author: mongoKart

snooty.toml

@@ -30,9 +30,9 @@ full-version = "{+version-number+}.0"
 version = "v{+version-number+}"
 mdb-server = "MongoDB Server"
 stable-api = "Stable API"
-api = "https://mongodb.github.io/mongo-java-driver/{+version-number+}/apidocs/mongodb-driver-kotlin-sync/mongodb-driver-kotlin-sync"
-java-api = "https://mongodb.github.io/mongo-java-driver/{+version-number+}"
-core-api = "{+java-api+}/apidocs/mongodb-driver-core"
+api-root = "https://mongodb.github.io/mongo-java-driver/{+version-number+}/apidocs"
+driver-api = "{+api-root+}/mongodb-driver-kotlin-sync/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client"
+core-api = "{+api-root+}/mongodb-driver-core/com/mongodb"
 kotlin-docs = "https://kotlinlang.org"
 serialization-version = "1.6.0"
 kotlinx-dt-version = "0.6.1"

source/agg-exp-ops.txt

@@ -216,5 +216,5 @@ API Documentation
 For more information about executing aggregation operations with the {+driver-short+},
 see the following API documentation:
 
-- `aggregate() <{+api+}/com.mongodb.kotlin.client/-mongo-collection/aggregate.html>`__
-- `AggregateIterable <{+api+}/com.mongodb.kotlin.client/-aggregate-iterable/index.html>`__
+- `aggregate() <{+driver-api+}/-mongo-collection/aggregate.html>`__
+- `AggregateIterable <{+driver-api+}/-aggregate-iterable/index.html>`__

source/aggregation.txt

@@ -8,19 +8,19 @@ API Documentation
    :titlesonly:
    :maxdepth: 1
 
-   {+language+} Sync Driver <{+java-api+}/apidocs/mongodb-driver-kotlin-sync/index.html>
-   BSON kotlinx.serialization <{+java-api+}/apidocs/bson-kotlinx/index.html>
-   {+language+} Driver Extensions <{+java-api+}/apidocs/mongodb-driver-kotlin-extensions/index.html>
-   Driver Core <{+core-api+}/index.html>
+   {+language+} Sync Driver <{+api-root+}/mongodb-driver-kotlin-sync/index.html>
+   BSON kotlinx.serialization <{+api-root+}/bson-kotlinx/index.html>
+   {+language+} Driver Extensions <{+api-root+}/mongodb-driver-kotlin-extensions/index.html>
+   Driver Core <{+api-root+}/mongodb-driver-core/index.html>
 
-- `{+language+} Sync Driver <{+java-api+}/apidocs/mongodb-driver-kotlin-sync/index.html>`__ -
+- `{+language+} Sync Driver <{+api-root+}/mongodb-driver-kotlin-sync/index.html>`__ -
   classes for the current synchronous driver API.
-- `BSON kotlinx.serialization <{+java-api+}/apidocs/bson-kotlinx/index.html>`__ -
+- `BSON kotlinx.serialization <{+api-root+}/bson-kotlinx/index.html>`__ -
   classes for encoding and decoding between Kotlin data classes and the BSON data
   format using :github:`kotlinx.serialization <Kotlin/kotlinx.serialization>`.
 - `{+language+} Driver Extensions
-  <{+java-api+}/apidocs/mongodb-driver-kotlin-extensions/index.html>`__ -
+  <{+api-root+}/mongodb-driver-kotlin-extensions/index.html>`__ -
   classes that extend the core builder classes to support :ref:`data
   classes <kotlin-sync-builders-data-classes>`.
-- `Driver Core <{+core-api+}/index.html>`__ - classes that
+- `Driver Core <{+api-root+}/mongodb-driver-core/index.html>`__ - classes that
   contain essential driver functionality.

source/api.txt

@@ -33,13 +33,13 @@ efficiently build queries and aggregations.
 To learn more about the available builder classes and methods, see the
 following API documentation sections:
 
-- `Accumulators <{+core-api+}/com/mongodb/client/model/Accumulators.html>`__
-- `Aggregates <{+core-api+}/com/mongodb/client/model/Aggregates.html>`__
-- `Filters <{+core-api+}/com/mongodb/client/model/Filters.html>`__
-- `Indexes <{+core-api+}/com/mongodb/client/model/Indexes.html>`__
-- `Projections <{+core-api+}/com/mongodb/client/model/Projections.html>`__
-- `Sorts <{+core-api+}/com/mongodb/client/model/Sorts.html>`__
-- `Updates <{+core-api+}/com/mongodb/client/model/Updates.html>`__
+- `Accumulators <{+core-api+}/client/model/Accumulators.html>`__
+- `Aggregates <{+core-api+}/client/model/Aggregates.html>`__
+- `Filters <{+core-api+}/client/model/Filters.html>`__
+- `Indexes <{+core-api+}/client/model/Indexes.html>`__
+- `Projections <{+core-api+}/client/model/Projections.html>`__
+- `Sorts <{+core-api+}/client/model/Sorts.html>`__
+- `Updates <{+core-api+}/client/model/Updates.html>`__
 
 Why Use Builders?
 -----------------

source/builders.txt

@@ -259,4 +259,4 @@ API Documentation
 -----------------
 
 - `{+driver-short+} Extensions
-  <{+core-api+}/apidocs/mongodb-driver-kotlin-extensions/index.html>`__
+  <{+api-root+}/mongodb-driver-kotlin-extensions/index.html>`__

source/builders/builders-data-classes.txt

@@ -341,9 +341,9 @@ API Documentation
 To learn more about the classes and methods mentioned in this guide, see
 the following API documentation:
 
-- `MongoClientSettings <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__
-- `MongoClientSettings.Builder <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html>`__
-- `ConnectionString <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/ConnectionString.html>`__
-- `SocketSettings <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/connection/SocketSettings.html>`__
-- `ClusterSettings <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/connection/ClusterSettings.html>`__
-- `MongoCredential <{+java-api+}/apidocs/mongodb-driver-core/com/mongodb/MongoCredential.html>`__
+- `MongoClientSettings <{+core-api+}/MongoClientSettings.html>`__
+- `MongoClientSettings.Builder <{+core-api+}/MongoClientSettings.Builder.html>`__
+- `ConnectionString <{+core-api+}/ConnectionString.html>`__
+- `SocketSettings <{+core-api+}/connection/SocketSettings.html>`__
+- `ClusterSettings <{+core-api+}/connection/ClusterSettings.html>`__
+- `MongoCredential <{+core-api+}/MongoCredential.html>`__

source/connect/connection-options.txt

@@ -126,5 +126,5 @@ API Documentation
 For more information about creating a ``MongoClient`` object with the 
 {+driver-short+}, see the following API documentation: 
 
-- `MongoClient <{+api+}/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client/-mongo-client/index.html>`__
-- `MongoClientSettings <{+core-api+}com/mongodb/MongoClientSettings.html>`__
+- `MongoClient <{+driver-api+}/-mongo-client/index.html>`__
+- `MongoClientSettings <{+core-api+}/MongoClientSettings.html>`__

source/connect/mongoclient.txt

@@ -123,11 +123,11 @@ API Documentation
 For more information about using the {+stable-api+} with the {+driver-short+}, see the 
 following API documentation: 
 
-- `ServerApi <{+core-api+}/com/mongodb/ServerApi.html>`__
-- `ServerApi.Builder <{+core-api+}/com/mongodb/ServerApi.Builder.html>`__
-- `ServerApiVersion <{+core-api+}/com/mongodb/ServerApiVersion.html>`__
-- `ServerAddress <{+core-api+}/com/mongodb/ServerAddress.html>`__
-- `MongoClientSettings <{+core-api+}/com/mongodb/MongoClientSettings.html>`__
-- `MongoClientSettings.Builder <{+core-api+}/com/mongodb/MongoClientSettings.Builder.html>`__
-- `MongoClient <{+api+}/com.mongodb.kotlin.client/-mongo-client/index.html>`__
-- `MongoClient.create() <{+api+}/com.mongodb.kotlin.client/-mongo-client/-factory/create.html>`__
+- `ServerApi <{+core-api+}/ServerApi.html>`__
+- `ServerApi.Builder <{+core-api+}/ServerApi.Builder.html>`__
+- `ServerApiVersion <{+core-api+}/ServerApiVersion.html>`__
+- `ServerAddress <{+core-api+}/ServerAddress.html>`__
+- `MongoClientSettings <{+core-api+}/MongoClientSettings.html>`__
+- `MongoClientSettings.Builder <{+core-api+}/MongoClientSettings.Builder.html>`__
+- `MongoClient <{+driver-api+}/-mongo-client/index.html>`__
+- `MongoClient.create() <{+driver-api+}/-mongo-client/-factory/create.html>`__

source/connect/stable-api.txt

@@ -325,5 +325,5 @@ API Documentation
 For more information about any of the methods or types discussed in this guide,
 see the following API documentation:
 
-- `ConnectionString <{+core-api+}/com/mongodb/ConnectionString.html>`__
-- `MongoClientSettings <{+core-api+}/com/mongodb/MongoClientSettings.html>`__
+- `ConnectionString <{+core-api+}/ConnectionString.html>`__
+- `MongoClientSettings <{+core-api+}/MongoClientSettings.html>`__