auth suggestion NR

Author: lindseymoore

source/fundamentals/auth.txt

@@ -48,29 +48,31 @@ Mechanisms
 ----------
 
 .. _default-auth-mechanism:
+.. _scram-sha-256-auth-mechanism:
 
-Default
-~~~~~~~
+``SCRAM-SHA-256``
+~~~~~~~~~~~~~~~~~
 
-The default authentication mechanism is ``SCRAM-SHA-256``.
+``SCRAM-SHA-256`` is a salted challenge-response authentication mechanism
+(SCRAM) that uses your username and password, encrypted with the ``SHA-256``
+algorithm, to authenticate your user. This is the default authentication
+mechanism.
 
 The following code snippets show how to specify the authentication mechanism,
 using the following placeholders:
 
-* ``db_username`` - your MongoDB database username
-* ``db_password`` - your MongoDB database user's password
-* ``hostname`` - network address of your MongoDB server, accessible by your client
-* ``port`` - port number of your MongoDB server
+* ``db_username`` - your MongoDB database username.
+* ``db_password`` - your MongoDB database user's password.
+* ``hostname`` - network address of your MongoDB server, accessible by your client.
+* ``port`` - port number of your MongoDB server.
 * ``authenticationDb`` - MongoDB database that contains your user's
   authentication data. If you omit this parameter, the driver uses the
   default value ``admin``.
 
 Select the :guilabel:`Connection String` or the :guilabel:`MongoCredential`
-tab below for instructions and sample code for specifying this authentication
+tab below for instructions and sample code to specify this default authentication
 mechanism:
 
-.. _mongo-client-setting-with-mongo-credential-example:
-
 .. tabs::
 
    .. tab::
@@ -93,33 +95,10 @@ mechanism:
       .. literalinclude:: /examples/generated/AuthTest.snippet.default-mongo-cred.kt
          :language: kotlin
 
-For more information on the challenge-response (CR) and salted
-challenge-response authentication mechanisms (SCRAM) that MongoDB supports,
-see the :manual:`SCRAM </core/security-scram/>` section of the Server manual.
-
-.. _scram-sha-256-auth-mechanism:
-
-``SCRAM-SHA-256``
-~~~~~~~~~~~~~~~~~
-
-``SCRAM-SHA-256`` is a salted challenge-response authentication mechanism
-(SCRAM) that uses your username and password, encrypted with the ``SHA-256``
-algorithm, to authenticate your user.
-
-The following code snippets show how to specify the authentication mechanism,
-using the following placeholders:
-
-* ``db_username`` - your MongoDB database username.
-* ``db_password`` - your MongoDB database user's password.
-* ``hostname`` - network address of your MongoDB server, accessible by your client.
-* ``port`` - port number of your MongoDB server.
-* ``authenticationDb`` - MongoDB database that contains your user's
-  authentication data. If you omit this parameter, the driver uses the
-  default value ``admin``.
-
-Select the :guilabel:`Connection String` or the :guilabel:`MongoCredential`
-tab below for instructions and sample code for specifying this authentication
-mechanism:
+You can also explicitly specify the ``SCRAM-SHA-256`` authentication mechanism,
+as shown in the following code snippets. Select the :guilabel:`Connection String` 
+or the :guilabel:`MongoCredential` tab below for instructions and sample code for 
+specifying this authentication mechanism:
 
 .. tabs::