[Java Sync] Connection Section Reorg (#648)

rachel-mack · web-flow · commit 6cf68b6ea716 · 2025-03-12T14:37:59.000-04:00
* connect conflict

* security pages

* connection security

* landing pages

* snooty

* secrurity options landing page

* NR feedback

* build errors

* label

* label fix

* NR feedback

* force rebuild
diff --git a/config/redirects b/config/redirects
@@ -43,7 +43,7 @@ raw: ${prefix}/master -> ${base}/upcoming/
 [v5.3-master]: ${prefix}/${version}/fundamentals/data-formats/pojo-customization/ -> ${base}/${version}/data-formats/pojo-customization/
 [v5.3-master]: ${prefix}/${version}/fundamentals/data-formats/codecs/ -> ${base}/${version}/data-formats/codecs/
 [v5.3-master]: ${prefix}/${version}/fundamentals/connection/ -> ${base}/${version}/connection/
-[v5.3-master]: ${prefix}/${version}/fundamentals/connection/connect/ -> ${base}/${version}/connection/connect/
+[v5.3-master]: ${prefix}/${version}/fundamentals/connection/connect/ -> ${base}/${version}/connection/mongoclient
 [v5.3-master]: ${prefix}/${version}/fundamentals/connection/connection-options/ -> ${base}/${version}/connection/connection-options/
 [v5.3-master]: ${prefix}/${version}/fundamentals/connection/mongoclientsettings/ -> ${base}/${version}/connection/mongoclientsettings/
 [v5.3-master]: ${prefix}/${version}/fundamentals/connection/network-compression/ -> ${base}/${version}/connection/network-compression/
diff --git a/snooty.toml b/snooty.toml
@@ -9,10 +9,12 @@ intersphinx = [
 toc_landing_pages = [
     "/get-started",
     "/connection",
+    "/connection/specify-connection-options",
     "/crud",
     "/crud/builders",
     "/data-formats",
     "/api-documentation",
+    "/security",
     "/security/auth"
 ]
 
diff --git a/source/connection.txt b/source/connection.txt
@@ -1,20 +1,14 @@
-.. _java-connection-guide:
+.. _java-connection-uri-guide:
 
 ================
 Connection Guide
 ================
 
 .. toctree::
 
-   Connect to MongoDB </connection/connect>
-   Connection Options </connection/connection-options>
-   MongoClient Settings </connection/mongoclientsettings>
-   Stable API </connection/stable-api>
-   Connection Pools </connection/connection-pools>
-   Network Compression </connection/network-compression>
-   JNDI Datasource </connection/jndi>
+   Create a MongoClient </connection/mongoclient>
+   Specify Connection Options </connection/specify-connection-options>
    Connection Troubleshooting </connection/connection-troubleshooting>
-   AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/>
 
 .. contents:: On this page
    :local:
@@ -29,14 +23,9 @@ Learn how to set up a connection and specify connection behavior from your
 application to a MongoDB deployment using the driver in the following
 sections:
 
-- :ref:`Connect to MongoDB <java-connect-to-mongodb>`
-- :ref:`View a List of Connection Options <connection-options>`
-- :ref:`Specify Connection Behavior with the MongoClient Class <specify-mongoclient-settings>`
-- :ref:`Enable Network Compression <java-compression>`
-- :ref:`Enable TLS/SSL on a Connection <tls-ssl>`
-- :ref:`Connect to MongoDB by Using a SOCKS5 Proxy <java-connect-socks>`
-- :ref:`Connect to MongoDB by Using a JNDI Datasource <jndi>`
-- :atlas:`Connect to MongoDB Atlas from AWS Lambda </manage-connections-aws-lambda/>`
+- :ref:`Create a MongoClient <java-mongoclient>`
+- :ref:`Specify Connection Options <java-specify-connection-options>`
+- :ref:`Connection Troubleshooting <java-connection-troubleshooting>`
 
 For information about authenticating with a MongoDB instance,
 see the :ref:`<java-authentication-mechanisms>` section.
diff --git a/source/connection/connection-troubleshooting.txt b/source/connection/connection-troubleshooting.txt
@@ -245,7 +245,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-options` guide.
+learn more, see the :ref:`java-connection-uri-options` guide.
 
 .. _java-miscellaneous-errors:
 
diff --git a/source/connection/mongoclient.txt b/source/connection/mongoclient.txt
@@ -1,8 +1,9 @@
 .. _java-connect-to-mongodb:
+.. _java-mongoclient:
 
-==================
-Connect to MongoDB
-==================
+====================
+Create a MongoClient
+====================
 
 .. contents:: On this page
    :local:
diff --git a/source/connection/specify-connection-options.txt b/source/connection/specify-connection-options.txt
@@ -0,0 +1,31 @@
+.. _java-specify-connection-options:
+
+==========================
+Specify Connection Options
+==========================
+
+.. toctree::
+
+   MongoClient Settings </connection/specify-connection-options/mongoclientsettings>
+   Connection URI Options </connection/specify-connection-options/connection-options.txt>
+   Stable API </connection/specify-connection-options/stable-api>
+   Network Compression </connection/specify-connection-options/network-compression>
+   JNDI Datasource </connection/specify-connection-options/jndi>
+   AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/>
+   Connection Security Settings </connection/specify-connection-options/security-connection-options>
+
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: connection string, URI, Atlas, code example
+
+
+- :ref:`MongoClient Settings <mongoclientsettings>`
+- :ref:`Connection URI Options <connection-options>`
+- :ref:`Stable API <stable-api-java>`
+- :ref:`Network Compression <network-compression>`
+- :ref:`JNDI Datasource <jndi>`
+- `AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/>`__
+- :ref:`Connection Security Options <security-connection-settings>`
diff --git a/source/connection/specify-connection-options/connection-options.txt b/source/connection/specify-connection-options/connection-options.txt
@@ -1,12 +1,12 @@
-.. _java-connection-options:
+.. _java-connection-uri-options:
 .. _connection-options:
 
-==================
-Connection Options
-==================
+======================
+Connection URI Options
+======================
 
 This section explains MongoDB connection and authentication options
-supported by the driver. You can pass the connection options as
+supported by the {+driver-short+}. You can pass the connection options as
 parameters of the connection URI to specify the behavior of the client.
 
 .. list-table::
diff --git a/source/connection/specify-connection-options/jndi.txt b/source/connection/specify-connection-options/jndi.txt
diff --git a/source/connection/specify-connection-options/mongoclientsettings.txt b/source/connection/specify-connection-options/mongoclientsettings.txt
diff --git a/source/connection/specify-connection-options/network-compression.txt b/source/connection/specify-connection-options/network-compression.txt
diff --git a/source/connection/specify-connection-options/security-connection-options.txt b/source/connection/specify-connection-options/security-connection-options.txt
@@ -0,0 +1,21 @@
+.. _security-connection-settings:
+
+============================
+Connection Security Settings
+============================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+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
diff --git a/source/connection/specify-connection-options/stable-api.txt b/source/connection/specify-connection-options/stable-api.txt
diff --git a/source/includes/security/security-pages.rst b/source/includes/security/security-pages.rst
@@ -0,0 +1,5 @@
+- :ref:`Authentication <authentication-mechanisms>`
+- :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>`
diff --git a/source/security.txt b/source/security.txt
@@ -1,3 +1,5 @@
+.. _java-security:
+
 ========
 Security
 ========
@@ -13,4 +15,12 @@ Security
    In-Use Encryption </security/encrypt-fields>
    TLS/SSL </security/tls>
    SOCKS5 Proxy </security/socks>
-   Validate Driver Artifact Signatures </security/validate-signatures>
+   Validate Driver Artifact Signatures </security/validate-signatures>
+
+Overview
+--------
+
+Learn how to set up security options for your application in the following
+sections:
+
+.. include:: /includes/security/security-pages.rst
