DOCSP-47061: Restructure authentication pages (#630)

* DOCSP-47061: Restructure authentication pages

* edits, build errors

* small fixes

* typo

* build errors

Author: norareidy

snooty.toml

@@ -12,7 +12,8 @@ toc_landing_pages = [
     "/crud",
     "/crud/builders",
     "/data-formats",
-    "/api-documentation"
+    "/api-documentation",
+    "/security/auth"
 ]
 
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"

source/connection.txt

@@ -28,7 +28,7 @@ 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 <connect-to-mongodb>`
+- :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 <network-compression>`
@@ -38,4 +38,4 @@ sections:
 - :atlas:`Connect to MongoDB Atlas from AWS Lambda </manage-connections-aws-lambda/>`
 
 For information about authenticating with a MongoDB instance,
-see :ref:`<authentication-mechanisms>` and :ref:`<enterprise-authentication-mechanisms>`.
+see the :ref:`<java-authentication-mechanisms>` section.

source/connection/connect.txt

@@ -1,4 +1,4 @@
-.. _connect-to-mongodb:
+.. _java-connect-to-mongodb:
 
 ==================
 Connect to MongoDB
@@ -34,8 +34,8 @@ Use the ``MongoClients.create()`` method to construct a ``MongoClient``.
    As each ``MongoClient`` represents a thread-safe pool of connections to the
    database, most applications only require a single instance of a
    ``MongoClient``, even across multiple threads. 
-All resource usage limits, such as max connections, apply to individual
-``MongoClient`` instances.
+   All resource usage limits, such as max connections, apply to individual
+   ``MongoClient`` instances.
 
 To learn about the different settings you can use to control the
 behavior of your ``MongoClient``, see the guide on

source/connection/connection-troubleshooting.txt

@@ -103,8 +103,8 @@ Connection Troubleshooting
 
    .. replacement:: authentication-guide-reference
 
-      To learn more about specifying authentication mechanisms, see the :ref:`authentication-mechanisms` and
-      :ref:`enterprise-authentication-mechanisms` guides.
+      To learn more about specifying authentication mechanisms, see the :ref:`java-authentication-mechanisms`
+      section.
 
    .. replacement:: verify-authentication-mechanism-anchor
 

source/connection/mongoclientsettings.txt

@@ -116,7 +116,7 @@ connection behavior:
        messages to the server.
 
    * - ``credential()``
-     - Sets the :ref:`credential <authentication-mechanisms-java>`.
+     - Sets the :ref:`credential <java-authentication-mechanisms>`.
 
    * - ``readConcern()``
      - Sets the :manual:`read concern </reference/read-concern/>`.

source/crud/aggregation.txt

@@ -114,7 +114,7 @@ Connect to a MongoDB Deployment
 .. tip::
 
    To learn more about connecting to MongoDB, see the :ref:`Connection
-   Guide <connect-to-mongodb>`.
+   Guide <java-connect-to-mongodb>`.
 
 Insert Sample Data
 ++++++++++++++++++

source/faq.txt

@@ -185,9 +185,8 @@ check the following items in your code:
 
 - The credentials for the authentication mechanism that you specified are
   correct. To learn how to specify your credentials, see the
-  :ref:`authentication-mechanisms` and :ref:`enterprise-authentication-mechanisms`
-  guides.
-
+  :ref:`java-authentication-mechanisms` section.
+  
 - The name of the authentication database that you specified is correct. To
   learn how to set up the users and roles for your MongoDB deployment, see
   `Manage Users and Roles <https://www.mongodb.com/docs/manual/tutorial/manage-users-and-roles/>`__

source/includes/connect-guide-note.rst

@@ -2,4 +2,4 @@
 
     This example connects to an instance of MongoDB using a connection URI.
     To learn more about connecting to your MongoDB instance, see the
-    :ref:`connection guide <connect-to-mongodb>`.
+    :ref:`connection guide <java-connect-to-mongodb>`.

source/security.txt

@@ -10,7 +10,6 @@ Security
    :maxdepth: 1
 
    Authentication </security/auth>
-   Enterprise Authentication </security/enterprise-auth>
    In-Use Encryption </security/encrypt-fields>
    TLS/SSL </security/tls>
    SOCKS5 Proxy </security/socks>