DOCSP-9032: feedback fixes for auth guides (#70)

Author: Chris Cho

source/fundamentals/authentication/enterprise-mechanisms.txt

@@ -18,7 +18,7 @@ authenticate to a Kerberos service.
 
 You can specify this authentication mechanism by setting the following
 parameters of the
-:manual:`URI ConnectionString </reference/connection-string/>`:
+:manual:`connection string </reference/connection-string/>`:
 
 - Set the ``authMechanism`` parameter to ``GSSAPI``
 - Set the ``gssapiServiceName`` if using a value other than ``mongodb``
@@ -27,6 +27,10 @@ parameters of the
 
 The following code sample authenticates to Kerberos for UNIX using ``GSSAPI``.
 
+.. important::
+   Always **URI encode** the principal using the ``encodeURIComponent`` method
+   to ensure it is correctly parsed.
+
 .. code-block:: js
 
    const { MongoClient } = require("mongodb");
@@ -74,7 +78,7 @@ authenticate to a Lightweight Directory Access Protocol (LDAP) server.
 
 You can specify this authentication mechanism by setting the ``authMechanism``
 parameter to ``PLAIN`` and including your LDAP username and password in the
-:manual:`URI ConnectionString </reference/connection-string/>` as shown
+:manual:`connection string </reference/connection-string/>` as shown
 in the following sample code.
 
 .. code-block:: js

source/fundamentals/authentication/mechanisms.txt

@@ -33,7 +33,7 @@ the driver attempts to authenticate using ``MONGODB-CR``.
 
 You can specify this authentication mechanism by setting the ``authMechanism``
 parameter to ``DEFAULT`` in the
-:manual:`URI ConnectionString </reference/connection-string/>`, or by omitting
+:manual:`connection string </reference/connection-string/>`, or by omitting
 the parameter since it is the default value. Also include your username and
 password as shown in the code below.
 
@@ -63,9 +63,13 @@ algorithm to authenticate your user.
 
 You can specify this authentication mechanism by setting the ``authMechanism``
 to the value ``SCRAM-SHA-256`` in the
-:manual:`URI ConnectionString </reference/connection-string/>` as shown in the
+:manual:`connection string <reference/connection-string/>` as shown in the
 following sample code.
 
+.. important::
+   Always **URI encode** the username and password using the
+   ``encodeURIComponent`` method to ensure they are correctly parsed.
+
 .. literalinclude:: /code-snippets/authentication/sha256.js
    :language: javascript
    :dedent: 4
@@ -83,9 +87,13 @@ your user.
 
 You can specify this authentication mechanism by setting the ``authMechanism``
 parameter to the value ``SCRAM-SHA-1`` in the
-:manual:`URI ConnectionString </reference/connection-string/>` as shown
+:manual:`connection string </reference/connection-string/>` as shown
 in the following sample code.
 
+.. important::
+   Always **URI encode** the username and password using the
+   ``encodeURIComponent`` method to ensure they are correctly parsed.
+
 .. literalinclude:: /code-snippets/authentication/sha1.js
    :language: javascript
    :dedent: 4
@@ -101,9 +109,13 @@ username and password to authenticate your user.
 
 You can specify this option by setting the ``authMechanism`` parameter to value
 ``MONGODB-CR`` in the
-:manual:`URI ConnectionString </reference/connection-string/>` as shown
+:manual:`connection string </reference/connection-string/>` as shown
 in the following sample code.
 
+.. important::
+   Always **URI encode** the username and password using the
+   ``encodeURIComponent`` method to ensure they are correctly parsed.
+
 .. literalinclude:: /code-snippets/authentication/cr.js
    :language: javascript
    :dedent: 4
@@ -129,14 +141,18 @@ the X.509 certificate, see the MongoDB manual :manual:`X.509 tutorial
 
 You can specify this authentication mechanism by setting the following
 parameters of your
-:manual:`URI ConnectionString </reference/connection-string/>`:
+:manual:`connection string </reference/connection-string/>`:
 
 - Set the ``authMechanism`` parameter to the value ``MONGODB-X509``
 - Set the ``tls`` parameter to the value ``true``
 
 Pass the location of your client certificate file as the value of
 ``tlsCertificateKeyFile`` as a parameter of the connection URI.
 
+.. important::
+   Always **URI encode** the username and certificate file path using the
+   ``encodeURIComponent`` method to ensure they are correctly parsed.
+
 .. literalinclude:: /code-snippets/authentication/x509.js
    :language: javascript
    :dedent: 4