DOCSP-48677: v5.4 release

rustagir · rustagir · commit 5e3f7f41dbcc · 2025-03-26T13:54:34.000-04:00
diff --git a/config/redirects b/config/redirects
@@ -1,19 +1,19 @@
 define: prefix docs/drivers/java/sync
 define: base https://www.mongodb.com/${prefix}
-define: versions v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 v4.10 v4.11 v5.0 v5.1 v5.2 v5.3 master
+define: versions v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 v4.10 v4.11 v5.0 v5.1 v5.2 v5.3 v5.4 master
 
-symlink: current -> v5.3
+symlink: current -> v5.4
 symlink: upcoming -> master
 
 raw: ${prefix}/ -> ${base}/current/
 raw: ${prefix}/master -> ${base}/upcoming/
 
 [*-v5.2]: ${prefix}/${version}/fundamentals/versioned-api/ -> ${base}/${version}/fundamentals/stable-api/
-[*-v4.6]: ${prefix}/${version}/fundamentals/crud/read-operations/change-streams/ -> ${base}/${version}/fundamentals/crud/read-operations/retrieve/
 [*-master]: ${prefix}/${version}/fundamentals/csfle/ -> ${base}/${version}/fundamentals/encrypt-fields/
 [*-master]: ${prefix}/${version}/fundamentals/crud/write-operations/change-a-document/ -> ${base}/${version}/fundamentals/crud/write-operations/modify/
-[*-v4.10]: ${prefix}/${version}/fundamentals/connection/socks/ -> ${base}/${version}/
-[*-v4.8]: ${prefix}/${version}/connection-troubleshooting/ -> ${base}/${version}/
+
+# TOC evolution redirects
+
 [v5.0-master]: ${prefix}/${version}/fundamentals/crud/ -> ${base}/${version}/crud/
 [v5.0-master]: ${prefix}/${version}/fundamentals/crud/read-operations/ -> ${base}/${version}/crud/query-documents/
 [v5.0-master]: ${prefix}/${version}/fundamentals/crud/read-operations/retrieve/ -> ${base}/${version}/crud/query-documents/find/
diff --git a/snooty.toml b/snooty.toml
@@ -17,7 +17,7 @@ toc_landing_pages = [
     "/logging-monitoring",
     "/api-documentation",
     "/security",
-    "/security/auth"
+    "/security/auth",
 ]
 
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
@@ -26,7 +26,7 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 driver = "java"
 driver-long = "MongoDB Java Driver"
 driver-short = "Java driver"
-version = "5.3"
+version = "5.4"
 full-version = "{+version+}.0"
 mdb-server = "MongoDB Server"
 package-name-org = "mongodb-org"
diff --git a/source/connection/connection-troubleshooting.txt b/source/connection/connection-troubleshooting.txt
@@ -250,7 +250,7 @@ against the connected secondary node if you set the read preference to
 
 You can also specify the ``serverSelectionTimeoutMS`` connection option
 to adjust the amount of time in which the driver must select a server. To
-learn more, see the :ref:`java-connection-uri-options` guide.
+learn more, see the :ref:`mcs-cluster-settings` guide.
 
 .. _java-miscellaneous-errors:
 
diff --git a/source/connection/specify-connection-options.txt b/source/connection/specify-connection-options.txt
@@ -26,6 +26,7 @@ Specify Connection Options
    Cluster Settings </connection/specify-connection-options/cluster-settings>
    Server Settings </connection/specify-connection-options/server-settings>
    Socket Settings </connection/specify-connection-options/socket-settings>
+   Security Settings </connection/specify-connection-options/security-connection-options>
    Configure Client-level CRUD Settings </connection/specify-connection-options/configure-crud>
    Network Compression </connection/specify-connection-options/network-compression>
    JNDI Datasource </connection/specify-connection-options/jndi>
@@ -63,4 +64,4 @@ You can learn how to using logging and monitoring with the {+driver-short+} in
 the :ref:`Logging and Monitoring section <java-logging-monitoring>`, which
 includes the following pages:
 
-.. include:: /includes/logging-monitoring/logging-monitoring-pages.rst
+.. include:: /includes/logging-monitoring/logging-monitoring-pages.rst
diff --git a/source/connection/specify-connection-options/security-connection-options.txt b/source/connection/specify-connection-options/security-connection-options.txt
@@ -18,4 +18,4 @@ MongoDB supports many options for securing your data before and during
 transportation. For information about security options, see our :ref:`Security
 section <java-security>`, which includes the following:
 
-.. include:: /includes/security/security-pages.rst
+.. include:: /includes/security/security-pages.rst
diff --git a/source/crud/query-documents/find.txt b/source/crud/query-documents/find.txt
@@ -56,7 +56,8 @@ retrieve.
 
 Call the ``find()`` method on an instance of a ``MongoCollection`` to filter for
 documents that match the provided query. For more information about how to
-specify a query, see our :doc:`Specify a Query </crud/query-document>` guide.
+specify a query, see our :ref:`java-query` guide.
+
 You can then use methods such as ``forEach()``  or ``cursor()`` to retrieve
 matching documents. For more information, see the `FindIterable
 <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/FindIterable.html>`__
diff --git a/source/includes/crud/example-intro.rst b/source/includes/crud/example-intro.rst
@@ -1,10 +1,10 @@
 .. note:: Example Setup
 
-    This example connects to an instance of MongoDB by using a connection URI. To learn
-    more about connecting to your MongoDB instance, see the :ref:`connection guide
-    <connect-to-mongodb>`. This example also uses the ``movies`` collection in the
-    ``sample_mflix`` database included in the :atlas:`Atlas sample datasets
-    </sample-data?jmp=docs_driver_java>`. You can load them into
-    your database on the free tier of MongoDB Atlas by following the :atlas:`Get
-    Started with Atlas Guide
-    </getting-started/#atlas-getting-started?jmp=docs_driver_java>`.
+    This example connects to an instance of MongoDB by using a
+    connection URI. To learn more about connecting to your MongoDB
+    instance, see the :ref:`java-connect-to-mongodb` guide. This example
+    also uses the ``movies`` collection in the ``sample_mflix`` database
+    included in the :atlas:`Atlas sample datasets </sample-data>`. You
+    can load them into your database on the free tier of MongoDB Atlas
+    by following the :atlas:`Get Started with Atlas Guide
+    </getting-started/#atlas-getting-started>`.
diff --git a/source/includes/language-compatibility-table-java.rst b/source/includes/language-compatibility-table-java.rst
@@ -12,7 +12,7 @@
      - Java 6
      - Java 5
 
-   * - 4.11 to 5.3
+   * - 4.11 to 5.4
      - ✓
      - ✓
      - ✓
@@ -57,4 +57,5 @@
      - ✓
      -
 
-.. [#virtual-threads-note] This driver version is not compatible with virtual threads.
+.. [#virtual-threads-note] This driver version is not compatible with
+    virtual threads.
diff --git a/source/includes/mongodb-compatibility-table-java.rst b/source/includes/mongodb-compatibility-table-java.rst
@@ -14,7 +14,7 @@
      - MongoDB 4.0
      - MongoDB 3.6
 
-   * - 5.2 to 5.3
+   * - 5.2 to 5.4
      - ✓
      - ✓
      - ✓
diff --git a/source/includes/security/security-pages.rst b/source/includes/security/security-pages.rst
@@ -2,4 +2,4 @@
 - :ref:`In-Use Encryption <java-fle>`
 - :ref:`TLS/SSL <tls-ssl>`
 - :ref:`SOCKS5 Proxy <java-connect-socks>`
-- :ref:`Validate Driver Artifact Signatures <java-validate-signatures>`
+- :ref:`Validate Driver Artifact Signatures <java-validate-signatures>`
diff --git a/source/index.txt b/source/index.txt
@@ -27,7 +27,7 @@ MongoDB Java Driver
    Data Formats </data-formats>
    Indexes </indexes>
    Run a Command </command>
-   Atlas Search <https://www.mongodb.com/docs/atlas/atlas-search/>
+   Atlas Search </atlas-search>
    Atlas Vector Search </atlas-vector-search>
    Logging and Monitoring </logging-monitoring>
    Security </security>
diff --git a/source/logging-monitoring/change-streams.txt b/source/logging-monitoring/change-streams.txt
@@ -1,6 +1,5 @@
 .. _java-fundamentals-change-streams:
 .. _retrieve-watch:
-.. _java-usage-watch:
 
 ===================
 Open Change Streams
@@ -109,12 +108,12 @@ You can call ``forEach()`` on the ``ChangeStreamIterable`` to handle
 events as they occur, or you can use the ``iterator()`` method which
 returns a ``MongoChangeStreamCursor`` instance that you can use to traverse the results.
 
-You can call the following methods on the ``MongoChangeStreamCursor`:
+You can call the following methods on a ``MongoChangeStreamCursor`` instance:
 
- - ``hasNext()``: checks if there are more results. 
- - ``next()`` returns the next document in the collection.
- - ``tryNext()`` immediately returns either the next available element in the
-   change stream or ``null``. 
+- ``hasNext()``: Checks if there are more results
+- ``next()``: Returns the next document in the collection
+- ``tryNext()``: Immediately returns either the next available element in the
+  change stream or ``null``
 
 .. important:: Iterating the Cursor Blocks the Current Thread
 
@@ -513,4 +512,5 @@ Server Manual Entries
 - :manual:`Change Streams </changeStreams/>`
 - :manual:`Change Events </reference/change-events/>`
 - :manual:`Aggregation Pipeline </reference/operator/aggregation-pipeline/>`
-- :manual:`Aggregation Stages </changeStreams/#modify-change-stream-output>`
+- :manual:`Aggregation Stages
+  </changeStreams/#modify-change-stream-output>`
diff --git a/source/reference.txt b/source/reference.txt
@@ -11,6 +11,5 @@ Reference
 
    Release Notes </references/whats-new>
    Compatibility </references/compatibility>
-   Third-Party Integrations </references/integrations/>
    Upgrade </references/upgrade>
-   Migrate from the Legacy API </references/legacy>
+   Migrate from the Legacy API </references/legacy>
diff --git a/source/references/whats-new.txt b/source/references/whats-new.txt
@@ -52,6 +52,10 @@ and features:
       the :ref:`java-oidc-kubernetes` section of the OIDC (Workload
       Identity Federation) guide
 
+   .. replacement:: atlas-query-operators
+
+      the :ref:`java-atlas-search` guide
+
 .. _java-version-5.3:
 
 What's New in 5.3
@@ -132,6 +136,12 @@ and features:
 
       :ref:`java-atlas-vector-search` in the Aggregates Builders guide
 
+   .. replacement:: csot-link
+
+      the `MongoClientSettings.Builder.timeout()
+      <{+core-api+}/com/mongodb/MongoClientSettings.Builder.html#timeout(long,java.util.concurrent.TimeUnit)>`__
+      API documentation
+
 .. _java-version-5.1.3:
 
 What's New in 5.1.3
diff --git a/source/security/socks.txt b/source/security/socks.txt
@@ -29,8 +29,8 @@ SOCKS5 Proxy Settings
 
 The proxy settings specify the SOCKS5 proxy server address and your
 authentication credentials. You can specify your settings in an instance of
-:ref:`MongoClientSettings <mongoclientsettings>` or in your :ref:`connection
-string <connection-uri>`.
+`MongoClientSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__
+or in your :ref:`connection string <connection-uri>`.
 
 .. important::
    
