Copy review 2

Author: melissamahoney-mongodb

source/configure/configuration-file.txt

@@ -12,7 +12,9 @@
    :depth: 1
    :class: singlecol
 
-The {+mcli+} configuration file stores your profiles. You can update the settings stored in your configuration file by editing the file with a text editor or by using the :ref:`mcli-config-set-command` command.
+The {+mcli+} configuration file stores your profiles. You can update the
+settings stored in your configuration file by editing the file with a
+text editor or by using the :ref:`mcli-config-set-command` command.
 
 .. include:: /includes/admonitions/secure-config-file.rst
 
@@ -23,9 +25,9 @@ The first time you run the :ref:`mcli-config-command` command, the
 {+mcli+} creates a configuration file called ``mongocli.toml``. The
 {+mcli+} grants the user who ran the command read and write access to
 the file. The {+mcli+} saves the configuration file to the folder where
-your system stores application configuration files, which is defined by
+the system stores application configuration files, which is defined by
 the ``$XDG_CONFIG_HOME`` environment variable. By default, this location
-is the ``/.config`` folder of your home directory. If this folder
+is the ``/.config`` folder of the user's home directory. If this folder
 doesn't exist, the {+mcli+} creates the folder and grants the user read,
 write, and execute permissions.
 
@@ -35,18 +37,23 @@ Profiles
 --------
 
 The {+mcli+} configuration file stores related settings and
-|api| keys in groups called *profiles*. You can create or define multiple profiles so that you can use the {+mcli+} to access different MongoDB services or projects from the same terminal.
+|api| keys in groups called *profiles*. You can create or define
+multiple profiles so that you can use the {+mcli+} to access different
+MongoDB services or projects from the same terminal.
 
-The {+mcli+} uses the ``default`` profile by default. To run {+mcli+}
-commands without the ``--profile`` flag, you must configure a profile named ``default``. To use a profile with any other name, you must specify that profile with the ``--profile`` flag in every command.
+To run {+mcli+} with a specific profile, append the ``--profile
+<profileName>`` option to the command. If you omit the ``--profile``
+parameter, {+mcli+} looks for a profile named ``default`` in the
+configuration file.
 
 Example
 -------
 
 The following example configuration file contains two profiles,
 ``default`` and ``myOpsManager``. 
 
-The ``default`` profile connects to a |service| deployment and contains the following settings:
+The ``default`` profile connects to a |service| deployment and contains
+the following settings:
 
 - An organization ID
 - |api| keys
@@ -80,3 +87,18 @@ contains contains the following settings:
      private_api_key = "e750d2bf-9101-4cde-1121-ca4dcbcac9a5"
      service = "ops-manager"
 
+To use {+mcli+} with the ``default`` profile, omit the ``--profile``
+option from the command:
+
+.. code-block:: sh
+   :copyable: false
+
+   mongocli <command>
+
+To use {+mcli+} with the ``myOpsManager`` profile, append the
+``--profile myOpsManager`` option to the command:
+
+.. code-block:: sh
+   :copyable: false
+
+   mongocli <command> --profile myOpsManager

source/includes/quick-start-intro.rst

@@ -1,11 +1,6 @@
 You can configure {+mcli+} access to your MongoDB service using
 the :ref:`mcli-config-command` and :ref:`mcli-config-set-command`
-commands. In the following steps, the commands:
+commands. 
 
-- Create the {+default-profile+} in the
-  :ref:`configuration file <mcli-config-file>`.
-- Set your programmatic |api| access keys and project ID in the
-  profile.
-
-You can use this profile with all the other commands in this
-tutorial.
+The following procedure creates the {+default-profile+} in the
+:ref:`configuration file <mcli-config-file>`. You can use this profile with all the other commands in this tutorial.

source/includes/steps-configure-mcli.yaml

@@ -24,7 +24,7 @@ content: |
 
         This command creates a profile with a custom name in the
         :ref:`mcli-config-file`. To use this profile, you must specify
-        it with the ``--profile`` flag in every command.
+        it with the ``--profile`` flag in every {+mcli+} command.
 
         Run the :ref:`mcli-config-command` command:
 
@@ -95,9 +95,9 @@ content: |
               cat ~/.config/mongocli.toml
           
            The command returns the contents of the configuration file,
-           which contains the {+default-profile+}. The ``default``
-           profile has a |svc-api-key| and project ID for an {{service}}
-           deployment.
+           which contains the {+default-profile+}. The
+           {+default-profile+} has a |svc-api-key| and project ID for an
+           {{service}} deployment.
 
            .. code-block:: sh
               :copyable: false
@@ -122,7 +122,10 @@ content: |
 
               cat ~/.config/mongocli.toml
           
-           The command returns the contents of the configuration file, which contains a profile named ``myMongoDB``. The ``myMongoDB`` profile has a |svc-api-key| and project ID for an {{service}} deployment.
+           The command returns the contents of the configuration file,
+           which contains a profile named ``myMongoDB``. The
+           ``myMongoDB`` profile has a |svc-api-key| and project ID for
+           an {{service}} deployment.
 
            .. code-block:: sh
               :copyable: false

source/quick-start.txt

@@ -131,10 +131,9 @@ To learn more about generating the |svc-api-key|, see:
       ---------------------
 
       If the |service| project does not yet have a MongoDB database user
-      configured, create one using the
-      :ref:`mcli-atlas-dbuser-create-command` command. The MongoDB user
-      can access the database hosted in |service|. Run the following
-      command to add a MongoDB user. 
+      configured, you must create one in order to access the database.
+      Run the :ref:`mcli-atlas-dbuser-create-command` command to add a
+      MongoDB database user. 
 
       The command creates a MongoDB user with the following attributes: 
 

source/reference/atlas/dbuser-create.txt

@@ -115,7 +115,7 @@ Example 1
 The following command creates a user with the following attributes:
 
 - Username: ``user1`` 
-- Password: ``passW0rd`` 
+- Password: ``ChangeThisToAStrongPassword`` 
 - Role: ``atlasAdmin`` 
 
 The command uses the {+default-profile+} to access |service| and create the
@@ -124,7 +124,7 @@ user.
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser create --username user1 --password passW0rd --role atlasAdmin@admin --projectId 5e2211c17a3e5a48f5497de3
+   mongocli atlas dbuser create --username user1 --password ChangeThisToAStrongPassword --role atlasAdmin@admin --projectId 5e2211c17a3e5a48f5497de3
 
 The previous command prints the following fields
 to the terminal. To learn more about these fields, see 
@@ -160,15 +160,15 @@ two privileges separated by a comma.
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser create --username egUser --password passW0rd --role readWriteAnyDatabase@admin,clusterMonitor@admin --projectId 5e2211c17a3e5a48f5497de3
+   mongocli atlas dbuser create --username egUser --password ChangeThisToAStrongPassword --role readWriteAnyDatabase@admin,clusterMonitor@admin --projectId 5e2211c17a3e5a48f5497de3
 
 The following command specifies the ``--role`` option twice, 
 once for each privilege.
 
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser create --username egUser --password passW0rd --role readWriteAnyDatabase@admin --role clusterMonitor@admin --projectId 5e2211c17a3e5a48f5497de3
+   mongocli atlas dbuser create --username egUser --password ChangeThisToAStrongPassword --role readWriteAnyDatabase@admin --role clusterMonitor@admin --projectId 5e2211c17a3e5a48f5497de3
 
 The commands print the following fields to the terminal. 
 To learn more about these fields, see :ref:`Output 

source/reference/atlas/dbuser-update.txt

@@ -104,14 +104,14 @@ command, it prints the :ref:`Output Fields
 Update Password Example 
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-The following command modifies ``egUser``'s password to ``passW0rd``.
+The following command modifies ``egUser``'s password to ``ChangeThisToAStrongPassword``.
 The command uses the {+default-profile+}, which contains the project ID and
 |svc-api-key|\s for accessing the cluster.
 
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser update egUser --password passW0rd
+   mongocli atlas dbuser update egUser --password ChangeThisToAStrongPassword
 
 The previous command prints the following fields
 to the terminal. To learn more about these fields, see 
@@ -146,7 +146,7 @@ contains the project ID and |svc-api-key|\s for accessing the cluster.
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser update egUser --password passW0rd --role readWriteAnyDatabase@admin,clusterMonitor@admin
+   mongocli atlas dbuser update egUser --password ChangeThisToAStrongPassword --role readWriteAnyDatabase@admin,clusterMonitor@admin
 
 The following command specifies the ``--role`` option twice, 
 once for each privilege. The command uses the {+default-profile+} where 
@@ -155,7 +155,7 @@ the project ID and |svc-api-key|\s for accessing the cluster are saved.
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas dbuser update egUser --password passW0rd --role readWriteAnyDatabase@admin --role clusterMonitor@admin
+   mongocli atlas dbuser update egUser --password ChangeThisToAStrongPassword --role readWriteAnyDatabase@admin --role clusterMonitor@admin
 
 The commands print the following fields to the terminal. 
 To learn more about these fields, see :ref:`Output 

source/reference/cloud-manager/dbuser-create.txt

@@ -121,7 +121,7 @@ Example 1
 The following command creates a user with the following attributes:
 
 - Username: ``user1`` 
-- Password: ``passW0rd``
+- Password: ``ChangeThisToAStrongPassword``
 - Role: ``readWrite@test``
 - Authentication mechanism: ``SCRAM-SHA-256``
 
@@ -131,7 +131,7 @@ The command uses the {+default-profile+} to access
 .. code-block:: sh
 
    mongocli cloud-manager dbuser create --username user1 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role readWrite@test \
      --mechanisms SCRAM-SHA-256
 
@@ -150,7 +150,7 @@ authentication mechanism enabled.
 .. code-block:: sh
 
    mongocli cloud-manager dbuser create --username user2 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role clusterMonitor,readWriteAnyDatabase
 
 The following command specifies the ``--role`` option twice, 
@@ -159,6 +159,6 @@ once for each privilege.
 .. code-block:: sh
 
    mongocli cloud-manager dbuser create --username user2 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role clusterMonitor \
      --role readWriteAnyDatabase

source/reference/ops-manager/dbuser-create.txt

@@ -115,7 +115,7 @@ Example 1
 The following command creates a user with the following attributes:
 
 - Username: ``user1`` 
-- Password: ``passW0rd``
+- Password: ``ChangeThisToAStrongPassword``
 - Role: ``readWrite@test``
 - Authentication mechanism: ``SCRAM-SHA-256``
 
@@ -125,7 +125,7 @@ The command uses the {+default-profile+} to access
 .. code-block:: sh
 
    mongocli ops-manager dbuser create --username user1 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role readWrite@test \
      --mechanisms SCRAM-SHA-256
 
@@ -144,7 +144,7 @@ authentication mechanism enabled.
 .. code-block:: sh
 
    mongocli ops-manager dbuser create --username user2 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role clusterMonitor,readWriteAnyDatabase
 
 The following command specifies the ``--role`` option twice, 
@@ -153,6 +153,6 @@ once for each privilege.
 .. code-block:: sh
 
    mongocli cloud-manager dbuser create --username user2 \
-     --password passW0rd \
+     --password ChangeThisToAStrongPassword \
      --role clusterMonitor \
      --role readWriteAnyDatabase

source/reference/ops-manager/owner-create.txt

@@ -164,7 +164,7 @@ first user for |mms| with the following attributes:
 
 - First name: ``Jane``
 - Last name: ``Doe``
-- Password: ``p@s$w0rD``
+- Password: ``ChangeThisToAStrongPassword``
 - Email address: ``[email protected]``
 - IP address for whitelist: ``123.456.78.9``
 
@@ -173,7 +173,7 @@ It uses the profile named ``omProfile`` for the |mms| base URL.
 .. code-block:: sh 
    :copyable: false
 
-   mongocli ops-manager owner create --firstName Jane --lastName Doe --password p@ssw0rD --email [email protected] --whitelistIps 123.456.78.9 --profile ``omProfile``
+   mongocli ops-manager owner create --firstName Jane --lastName Doe --password CHangeThisToAStrongPassword --email [email protected] --whitelistIps 123.456.78.9 --profile ``omProfile``
 
 .. _om-owner-create-example2: