rr feedback

Author: mongoKart

snooty.toml

@@ -30,8 +30,9 @@ version = "5.4"
 full-version = "{+version+}.0"
 mdb-server = "MongoDB Server"
 package-name-org = "mongodb-org"
-driver-api = "https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-sync/com/mongodb/client"
-core-api = "https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-core/com/mongodb"
+api-root = "https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs"
+driver-api = "{+api-root+}/mongodb-driver-sync/com/mongodb/client"
+core-api = "{+api-root+}/mongodb-driver-core/com/mongodb"
 stable-api = "Stable API"
 mongocrypt-version = "{+full-version+}"
 nettyVersion = "io.netty:netty-all:4.1.87.Final"

source/api-documentation.txt

@@ -7,26 +7,26 @@ API Documentation
 .. meta::
    :description: Read the API documentation for the {+driver-long+} and related packages.
 
-- `BSON <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/index.html>`__ - classes for working with the 
+- `BSON <{+api-root+}/bson/index.html>`__ - classes for working with the 
   BSON data format.
-- `BSON Record Codec <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson-record-codec/index.html>`__ - 
+- `BSON Record Codec <{+api-root+}/bson-record-codec/index.html>`__ - 
   classes for encoding and decoding between Java records and the BSON data 
   format.
-- `Core <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-core/index.html>`__ - classes that
+- `Core <{+api-root+}/mongodb-driver-core/index.html>`__ - classes that
   contain essential driver functionality.
-- `Java Driver (modern API) <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-sync/index.html>`__ -
+- `Java Driver (modern API) <{+api-root+}/mongodb-driver-sync/index.html>`__ -
   classes for the current driver API.
-- `Java Driver (legacy API) <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-legacy/index.html>`__ -
+- `Java Driver (legacy API) <{+api-root+}/mongodb-driver-legacy/index.html>`__ -
   classes that support the legacy driver API. To learn how to upgrade from the
   legacy API to the modern API from the :ref:`<java-legacy-api>` documentation.
 
 .. toctree::
    :titlesonly:
    :maxdepth: 1
 
-    BSON <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/index.html>
-    BSON Record Codec <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson-record-codec/index.html>
-    Core <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-core/index.html>
-    Java Driver (modern API) <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-sync/index.html>
-    Java Driver (legacy API) <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/mongodb-driver-legacy/index.html>
+    BSON <{+api-root+}/bson/index.html>
+    BSON Record Codec <{+api-root+}/bson-record-codec/index.html>
+    Core <{+api-root+}/mongodb-driver-core/index.html>
+    Java Driver (modern API) <{+api-root+}/mongodb-driver-sync/index.html>
+    Java Driver (legacy API) <{+api-root+}/mongodb-driver-legacy/index.html>
 

source/atlas-vector-search.txt

@@ -104,4 +104,4 @@ guide, see the following API documentation:
 - `Projections.metaVectorSearchScore()
   <{+core-api+}/client/model/Projections.html#metaVectorSearchScore(java.lang.String)>`__
 
-- `BinaryVector <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BinaryVector.html>`__
+- `BinaryVector <{+api-root+}/bson/org/bson/BinaryVector.html>`__

source/builders/indexes.txt

@@ -31,7 +31,7 @@ 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.
-Each method returns a `BSON <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/conversions/Bson.html>`__
+Each method returns a `BSON <{+api-root+}/bson/org/bson/conversions/Bson.html>`__
 instance, which you can pass to
 `createIndex() <{+driver-api+}/MongoCollection.html#createIndex(org.bson.conversions.Bson,com.mongodb.client.model.IndexOptions)>`__.
 

source/builders/sort.txt

@@ -69,7 +69,7 @@ For more information about the classes and interfaces in this section, see the
 following API Documentation:
 
 - `Sorts <{+core-api+}/client/model/Sorts.html>`__
-- `BSON <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/conversions/Bson.html>`__
+- `BSON <{+api-root+}/bson/org/bson/conversions/Bson.html>`__
 - `FindIterable <{+driver-api+}/FindIterable.html>`__
 - `Aggregates <{+core-api+}/client/model/Aggregates.html>`__
 

source/crud/query-documents/sort.txt

@@ -56,7 +56,7 @@ within an aggregation pipeline. To sort your query results, use the
 aggregation pipeline, use the ``Aggregates.sort()`` static factory method. Both
 of these methods receive objects that implement the ``Bson`` interface as
 arguments. For more information, see our API Documentation for the 
-`BSON interface <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/conversions/Bson.html>`__.
+`BSON interface <{+api-root+}/bson/org/bson/conversions/Bson.html>`__.
 
 You can use the ``sort()`` method of a ``FindIterable`` instance as follows:
 
@@ -105,8 +105,8 @@ following API Documentation:
 - `FindIterable <{+driver-api+}/FindIterable.html>`__
 - `Aggregates <{+core-api+}/client/model/Aggregates.html>`__
 - `Sorts <{+core-api+}/client/model/Sorts.html>`__
-- `BSON <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/conversions/Bson.html>`__
-- `Document <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/Document.html>`__
+- `BSON <{+api-root+}/bson/org/bson/conversions/Bson.html>`__
+- `Document <{+api-root+}/bson/org/bson/Document.html>`__
 
 Sorting Direction
 -----------------

source/data-formats/codecs.txt

@@ -136,13 +136,13 @@ section of this page to see how you can include your ``Codec``.
 For more information about the classes and interfaces in this section, see the
 following API Documentation:
 
-- `Codec <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/Codec.html>`__
-- `BsonWriter <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonWriter.html>`__
-- `BsonBinaryWriter <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonBinaryWriter.html>`__
-- `EncoderContext <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/EncoderContext.html>`__
-- `BsonReader <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonReader.html>`__
-- `DecoderContext <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/DecoderContext.html>`__
-- `BsonBinaryReader <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonBinaryReader.html>`__
+- `Codec <{+api-root+}/bson/org/bson/codecs/Codec.html>`__
+- `BsonWriter <{+api-root+}/bson/org/bson/BsonWriter.html>`__
+- `BsonBinaryWriter <{+api-root+}/bson/org/bson/BsonBinaryWriter.html>`__
+- `EncoderContext <{+api-root+}/bson/org/bson/codecs/EncoderContext.html>`__
+- `BsonReader <{+api-root+}/bson/org/bson/BsonReader.html>`__
+- `DecoderContext <{+api-root+}/bson/org/bson/codecs/DecoderContext.html>`__
+- `BsonBinaryReader <{+api-root+}/bson/org/bson/BsonBinaryReader.html>`__
 
 .. _codecs-codecregistry:
 
@@ -190,8 +190,8 @@ exception.
 For more information about the classes and interfaces in this section, see the
 following API Documentation:
 
-- `CodecRegistries <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecRegistries.html>`__
-- `IntegerCodec <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/IntegerCodec.html>`__
+- `CodecRegistries <{+api-root+}/bson/org/bson/codecs/configuration/CodecRegistries.html>`__
+- `IntegerCodec <{+api-root+}/bson/org/bson/codecs/IntegerCodec.html>`__
 
 .. _codecs-codecprovider:
 
@@ -260,7 +260,7 @@ list prior to the default codec registry as shown in the example below:
 For more information about the classes and interfaces in this section, see
 the following API documentation sections:
 
-- `CodecProvider <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecProvider.html>`__
+- `CodecProvider <{+api-root+}/bson/org/bson/codecs/configuration/CodecProvider.html>`__
 - `Default codec registry <{+core-api+}/MongoClientSettings.html#getDefaultCodecRegistry()>`__
 
 
@@ -317,7 +317,7 @@ This code outputs the following:
    Java type: java.util.Set
 
 For a complete list of the default mappings, see the
-`BsonTypeClassMap <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/BsonTypeClassMap.html>`__ API Documentation.
+`BsonTypeClassMap <{+api-root+}/bson/org/bson/codecs/BsonTypeClassMap.html>`__ API Documentation.
 
 For an example of how the ``Document`` class uses ``BsonTypeClassMap``, see
 the driver source code for the following classes:
@@ -403,5 +403,5 @@ see the following API Documentation:
 
 - `withCodecRegistry() <{+driver-api+}/MongoCollection.html#withCodecRegistry(org.bson.codecs.configuration.CodecRegistry)>`__
 - `MongoClientSettings.getDefaultCodecRegistry() <{+core-api+}/MongoClientSettings.html#getDefaultCodecRegistry()>`__
-- `Codec <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/Codec.html>`__
-- `CodecProvider <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecProvider.html>`__
+- `Codec <{+api-root+}/bson/org/bson/codecs/Codec.html>`__
+- `CodecProvider <{+api-root+}/bson/org/bson/codecs/configuration/CodecProvider.html>`__

source/data-formats/document-data-format-bson.txt

@@ -38,13 +38,13 @@ MongoDB and BSON
 
 The MongoDB Java Driver, which uses the BSON library, allows you to work
 with BSON data by using one of the object types that implements the
-`BSON interface <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/conversions/Bson.html>`__,
+`BSON interface <{+api-root+}/bson/org/bson/conversions/Bson.html>`__,
 including:
 
-- `Document <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/Document.html>`__ (BSON library package)
-- `BsonDocument <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonDocument.html>`__ (BSON library package)
-- `RawBsonDocument <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/RawBsonDocument.html>`__ (BSON library package)
-- `JsonObject <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonObject.html>`__ (BSON library package)
+- `Document <{+api-root+}/bson/org/bson/Document.html>`__ (BSON library package)
+- `BsonDocument <{+api-root+}/bson/org/bson/BsonDocument.html>`__ (BSON library package)
+- `RawBsonDocument <{+api-root+}/bson/org/bson/RawBsonDocument.html>`__ (BSON library package)
+- `JsonObject <{+api-root+}/bson/org/bson/json/JsonObject.html>`__ (BSON library package)
 - `BasicDBObject <{+core-api+}/BasicDBObject.html>`__ (Java Driver package)
 
 For more information about using these object types, see our

source/data-formats/document-data-format-extended-json.txt

@@ -86,7 +86,7 @@ resources:
 
 - `JSON RFC <https://tools.ietf.org/html/rfc7159>`__ Official Documentation
 - :manual:`MongoDB Extended JSON </reference/mongodb-extended-json/>` Server Manual Entry
-- `BsonBinary <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/BsonBinary.html>`__ API Documentation
+- `BsonBinary <{+api-root+}/bson/org/bson/BsonBinary.html>`__ API Documentation
 - `Extended JSON specification <https://github.com/mongodb/specifications/blob/master/source/extended-json.rst>`__ GitHub Documentation
 
 Extended JSON Examples
@@ -226,7 +226,7 @@ an Extended JSON string into Java objects:
 
 
 For more information, see the `JsonReader
-<https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonReader.html>`__ API Documentation.
+<{+api-root+}/bson/org/bson/json/JsonReader.html>`__ API Documentation.
 
 Write Extended JSON
 -------------------
@@ -296,9 +296,9 @@ by passing the ``outputMode()`` builder method the ``JsonMode.EXTENDED`` constan
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
 
-- `JsonWriter <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonWriter.html>`__
-- `JsonWriterSettings <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonWriterSettings.html>`__
-- `outputMode() <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonWriterSettings.Builder.html#outputMode(org.bson.json.JsonMode)>`__
+- `JsonWriter <{+api-root+}/bson/org/bson/json/JsonWriter.html>`__
+- `JsonWriterSettings <{+api-root+}/bson/org/bson/json/JsonWriterSettings.html>`__
+- `outputMode() <{+api-root+}/bson/org/bson/json/JsonWriterSettings.Builder.html#outputMode(org.bson.json.JsonMode)>`__
 
 Custom BSON Type Conversion
 ---------------------------
@@ -346,5 +346,5 @@ Without specifying the converters, the Relaxed mode JSON output resembles the fo
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
 
-- `Converter <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/Converter.html>`__
-- `JsonWriterSettings.Builder <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/json/JsonWriterSettings.Builder.html>`__
+- `Converter <{+api-root+}/bson/org/bson/json/Converter.html>`__
+- `JsonWriterSettings.Builder <{+api-root+}/bson/org/bson/json/JsonWriterSettings.Builder.html>`__

source/data-formats/document-data-format-pojo.txt

@@ -197,14 +197,14 @@ The example prints the following output:
 For more information about the methods and classes mentioned in this section,
 see the following API documentation:
 
-- `CodecRegistry <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecRegistry.html>`__
+- `CodecRegistry <{+api-root+}/bson/org/bson/codecs/configuration/CodecRegistry.html>`__
 - `TDocument <{+driver-api+}/MongoCollection.html>`__
-- `PojoCodecProvider <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/pojo/PojoCodecProvider.html>`__
-- `automatic(true) <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/pojo/PojoCodecProvider.Builder.html#automatic(boolean)>`__
-- `PojoCodecProvider.Builder <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/pojo/PojoCodecProvider.Builder.html>`__
-- `fromRegistries() <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecRegistries.html#fromRegistries(org.bson.codecs.configuration.CodecRegistry...)>`__
+- `PojoCodecProvider <{+api-root+}/bson/org/bson/codecs/pojo/PojoCodecProvider.html>`__
+- `automatic(true) <{+api-root+}/bson/org/bson/codecs/pojo/PojoCodecProvider.Builder.html#automatic(boolean)>`__
+- `PojoCodecProvider.Builder <{+api-root+}/bson/org/bson/codecs/pojo/PojoCodecProvider.Builder.html>`__
+- `fromRegistries() <{+api-root+}/bson/org/bson/codecs/configuration/CodecRegistries.html#fromRegistries(org.bson.codecs.configuration.CodecRegistry...)>`__
 - `getDefaultCodecRegistry() <{+core-api+}/MongoClientSettings.html?is-external=true#getDefaultCodecRegistry()>`__
-- `fromProviders() <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/configuration/CodecRegistries.html#fromProviders(org.bson.codecs.configuration.CodecProvider...)>`__
+- `fromProviders() <{+api-root+}/bson/org/bson/codecs/configuration/CodecRegistries.html#fromProviders(org.bson.codecs.configuration.CodecProvider...)>`__
 
 Frequently Asked Questions
 --------------------------

source/data-formats/document-data-format-record.txt

@@ -108,7 +108,7 @@ Specify Component Conversion Using Annotations
 This section describes how to configure the serialization behavior of record components
 by using annotations. For a full list of supported annotations, see the
 `org.bson.codecs.pojo.annotations package API documentation.
-<https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/pojo/annotations/package-summary.html>`__
+<{+api-root+}/bson/org/bson/codecs/pojo/annotations/package-summary.html>`__
 
 .. note::
 
@@ -179,7 +179,7 @@ as shown in the following code:
 
    The ``org.bson.codecs.records.annotations`` package is deprecated. Use the equivalent
    annotations from the `org.bson.codecs.pojo.annotations
-   <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson/org/bson/codecs/pojo/annotations/package-summary.html>`__ package
+   <{+api-root+}/bson/org/bson/codecs/pojo/annotations/package-summary.html>`__ package
    instead.
 
 Operations with Recursive Types
@@ -233,4 +233,4 @@ see :ref:`Codecs <fundamentals-codecs>`.
 You can't create a record codec directly, but you can use the
 ``RecordCodecProvider`` to implement the record codec in your code. Learn more
 about the ``RecordCodecProvider``, see the
-`API documentation <https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs/bson-record-codec/org/bson/codecs/record/RecordCodecProvider.html>`__.
+`API documentation <{+api-root+}/bson-record-codec/org/bson/codecs/record/RecordCodecProvider.html>`__.