DOCSP-42374: go username/pass placeholders (mongodb#378)

Author: rustagir

source/connection-troubleshooting.txt

@@ -139,7 +139,7 @@ To learn more about authentication, see the
 Verify User Is in Authentication Database
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To successfully authenticate a connection by using a username and password,
+To successfully authenticate a connection by using a database username and password,
 the username must be defined in the authentication database. The default
 authentication database is the ``admin`` database. To use a different database
 for authentication, specify the ``authSource`` in the connection string. The
@@ -149,7 +149,7 @@ database:
 .. code-block:: go
    :copyable: true
 
-   uri := "mongodb://<username>:<password>@<hostname>:<port>/?authSource=users"
+   uri := "mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=users"
    client, err := mongo.Connect(options.Client().ApplyURI(uri))
 
 Error Sending Message
@@ -237,7 +237,7 @@ connection string option:
 
 .. code-block:: go
 
-   uri := "mongodb://<username>:<password>@<hostname>:27017/?timeoutMS=5000"
+   uri := "mongodb://<db_username>:<db_password>@<hostname>:27017/?timeoutMS=5000"
    client, err := mongo.Connect(options.Client().ApplyURI(uri))
 
 Check the Number of Connections

source/fundamentals/auth.txt

@@ -53,8 +53,8 @@ Example Conventions
 
 Each authentication mechanism contains the following placeholders:
 
-* ``username`` - Your MongoDB username
-* ``password`` - Your MongoDB user's password
+* ``db_username`` - Your MongoDB database username
+* ``db_password`` - Your MongoDB database user's password
 * ``hostname`` - Your MongoDB servers network address, accessible by
   your client
 * ``port`` - Your MongoDB servers port number
@@ -94,8 +94,8 @@ To specify the default authentication mechanism, omit the
 
    credential := options.Credential{
       AuthSource: "<authenticationDb>",
-      Username: "<username>",
-      Password: "<password>",
+      Username: "<db_username>",
+      Password: "<db_password>",
    }
    clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
       SetAuth(credential)
@@ -117,7 +117,7 @@ see the :manual:`SCRAM </core/security-scram/>` section of the server manual.
    in MongoDB 4.0.
 
 ``SCRAM-SHA-256`` is a salted challenge-response authentication mechanism
-(SCRAM) that uses your username and password, encrypted with the ``SHA-256``
+(SCRAM) that uses your database username and password, encrypted with the ``SHA-256``
 algorithm, to authenticate your user.
 
 To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
@@ -129,8 +129,8 @@ To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
    credential := options.Credential{
       AuthMechanism: "SCRAM-SHA-256",
       AuthSource: "<authenticationDb>",
-      Username: "<username>",
-      Password: "<password>",
+      Username: "<db_username>",
+      Password: "<db_password>",
    }
    clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
       SetAuth(credential)
@@ -161,8 +161,8 @@ To specify the ``SCRAM-SHA-1`` authentication mechanism, assign the
    credential := options.Credential{
       AuthMechanism: "SCRAM-SHA-1",
       AuthSource: "<authenticationDb>",
-      Username: "<username>",
-      Password: "<password>",
+      Username: "<db_username>",
+      Password: "<db_password>",
    }
    clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
       SetAuth(credential)

source/fundamentals/connections/connection-guide.txt

@@ -54,9 +54,9 @@ You can also use the :manual:`DNS Seed List Connection Format
 want more flexibility of deployment and the ability to change the
 servers in rotation without reconfiguring clients.
 
-The next part of the connection string contains your username and, if
+The next part of the connection string contains your database username and, if
 you are using password-based authentication, your password. Replace the value of
-``user`` with your username and ``pass`` with your password. If you are using an
+``user`` with your database username and ``pass`` with your password. If you are using an
 authentication mechanism that does not require a username and password, omit
 this part of the connection URI.
 

source/fundamentals/enterprise-auth.txt

@@ -71,7 +71,7 @@ Example
 This example specifies the authentication mechanism using the following
 placeholders:
 
-- ``username``: Your Kerberos principal. A sample username is ``[email protected]``.
+- ``Kerberos principal``: Your Kerberos principal. A sample username is ``[email protected]``.
 - ``password``: Your Kerberos user's password. You can also store your
   password in a ``keytab`` file to avoid exposing your
   password in your code.
@@ -85,7 +85,7 @@ preferences:
 
    credential := options.Credential{
            AuthMechanism: "GSSAPI",
-           Username:      "<username>",
+           Username:      "<Kerberos principal>",
            Password:      "<password>",
            PasswordSet:   true,
    }
@@ -116,7 +116,7 @@ MongoDB server:
 
 .. code-block:: go
 
-   uri := "mongodb://<username>:<password>@<hostname>/?authMechanism=GSSAPI"
+   uri := "mongodb://<Kerberos principal>:<password>@<hostname>/?authMechanism=GSSAPI"
 
 Set Custom ``SERVICE_NAME`` and ``SERVICE_REALM`` Fields
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -132,7 +132,7 @@ for the ``SERVICE_NAME`` and ``SERVICE_REALM`` fields when defining a
 
    credential := options.Credential{
            AuthMechanism: "GSSAPI",
-           Username:      "<username>",
+           Username:      "<Kerberos principal>",
            Password:      "<password>",
            AuthMechanismProperties: map[string]string{
                    "SERVICE_REALM": "<Kerberos service realm>",
@@ -162,7 +162,7 @@ Example
 This example specifies the authentication mechanism using the following
 placeholders:
 
-- ``username``: Your LDAP username
+- ``LDAP username``: Your LDAP username
 - ``password``: Your LDAP password
 - ``connection uri``: Your connection string URI
 
@@ -174,7 +174,7 @@ preferences:
 
    credential := options.Credential{
            AuthMechanism: "PLAIN",
-           Username:      "<username>",
+           Username:      "<LDAP username>",
            Password:      "<password>",
 	}
 
@@ -189,7 +189,7 @@ address of your MongoDB server:
 
 .. code-block:: go
 
-   uri := "mongodb://<username>:<password>@<hostname>/?authMechanism=PLAIN"
+   uri := "mongodb://<LDAP username>:<password>@<hostname>/?authMechanism=PLAIN"
 
 .. note::
 

source/usage-examples.txt

@@ -78,7 +78,6 @@ your connection string.
 
 .. _golang-usage-examples-env-variable:
 
-
 You can use `GoDotEnv <https://github.com/joho/godotenv>`__ to define
 your environment variable.
 
@@ -89,7 +88,7 @@ deployment's connection string. To learn more, see the
 
 .. code-block::
 
-   MONGODB_URI=mongodb+srv://<user>:<password>@<cluster-url>?retryWrites=true&w=majority
+   MONGODB_URI=mongodb+srv://<db_username>:<db_password>@<cluster-url>?retryWrites=true&w=majority
 
 Examples
 --------