More updates

Author: melissamahoney-mongodb

conf.py

@@ -57,7 +57,7 @@
 pygments_style = 'sphinx'
 
 source_constants = {
-    'default-profile': ':ref:`default profile <mcli-config-file>`',
+    'default-profile': ':ref:`default profile <mcli-profiles>`',
     'version': version,
     'mcli': 'MongoDB CLI',
     'mcli-long': 'MongoDB Command Line Interface (``mongocli``)',

snooty.toml

@@ -1,7 +1,7 @@
 name = "mongocli"
 
 [constants]
-default-profile = ":ref:`default profile <mcli-config-file>`"
+default-profile = ":ref:`default profile <mcli-profiles>`"
 mcli = "MongoDB CLI"
 mcli-long = "MongoDB Command Line Interface (``mongocli``)"
 mcli-version = "0.5.0"

source/configure/configuration-file.txt

@@ -12,12 +12,7 @@
    :depth: 1
    :class: singlecol
 
-The {+mcli+} configuration file stores related settings and
-|api| keys in groups called *profiles*. You can define multiple profiles
-so that you can use the {+mcli+} to access different MongoDB services or
-projects from the same terminal. 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
 
@@ -34,14 +29,26 @@ is the ``/.config`` folder of your home directory. If this folder
 doesn't exist, the {+mcli+} creates the folder and grants you read,
 write, and execute permissions.
 
+.. _mcli-profiles:
+
+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.
+
+The {+mcli+} uses the ``default`` profile by default. To run {+mcli+}
+commands without the ``--profile`` flag, you must use a profile named
+``default``. To use a profile with any other name, you must specify the
+``--profile`` flag for every command.
+
 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
@@ -55,11 +62,6 @@ contains contains the following settings:
 - |api| keys
 - A project ID
 
-.. note:: 
-   When you run a {+mcli+} command without the ``--profile`` flag, the
-   {+mcli+} uses the profile named ``default`` by default. To use a
-   profile with another name, you must specify it in the command with the ``--profile`` flag.
-
 .. code-block:: text
    :copyable: false
 
@@ -79,3 +81,4 @@ contains contains the following settings:
      project_id = "kk12jdn43jd123dkdkf97jg"
      private_api_key = "e750d2bf-9101-4cde-1121-ca4dcbcac9a5"
      service = "ops-manager"
+

source/includes/admonitions/note-atlas-api-free-tier-limits.rst

@@ -1,5 +1,5 @@
 .. note::
 
    This feature is not available for ``M0`` (Free Tier) clusters. For
-   more information, see :ref:`Atlas M0 (Free Tier) Limitations
-   <atlas-free-tier>`.
+   more information, see :atlas:`Atlas M0 (Free Tier) Limitations
+   </reference/free-shared-limitations/index.html>`.

source/includes/steps-configure-mcli.yaml

@@ -7,32 +7,31 @@ content: |
   .. tabs::
 
      .. tab:: Default Profile
-        :tab-id: default-profile
-
-        Run the :ref:`mcli-config-command` command:
-
-        .. code-block:: sh
-              
-          mongocli config {{serviceOption}}
+        :tabid: default-profile
 
         This command creates a profile called ``default`` in the
         :ref:`mcli-config-file`. The {+mcli+} uses this profile by
         default.
-        
-     .. tab:: Named Profile
-        :tab-id: named-profile
 
-  
         Run the :ref:`mcli-config-command` command:
 
         .. code-block:: sh
               
-          mongocli config {{serviceOption}} --profile <profile-name>
+          mongocli config {{serviceOption}}
+        
+     .. tab:: Named Profile
+        :tabid: named-profile
 
         This command creates a profile with a custom name in the
         :ref:`mcli-config-file`. To use this profile im subsequent
         {+mcli+} commands, you must run the commands with the
         ``--profile`` flag.
+
+        Run the :ref:`mcli-config-command` command:
+
+        .. code-block:: sh
+              
+          mongocli config {{serviceOption}} --profile <profile-name>
   
 ---
 title: "Enter your |onprem| Base |url|"
@@ -82,7 +81,7 @@ content: |
      :hidden:
     
      .. tab:: Default Profile
-        :tab-id: default-profile
+        :tabid: default-profile
 
         .. example::
 
@@ -110,7 +109,7 @@ content: |
               service = "{{serviceName}}"
 
      .. tab:: Named Profile
-        :tab-id: named-profile
+        :tabid: named-profile
         
         .. example::
 

source/includes/steps-quick-start-atlas-config-mcli.yaml

@@ -1,7 +1,10 @@
 stepnum: 1
 source:
   file: steps-quick-start-config-mcli.yaml
-  ref: quick-atlas-profile
+  ref: quick-create-profile
+replacement:
+  mdbService: Atlas
+  serviceOption: ""
 ---
 stepnum: 2
 source:

source/includes/steps-quick-start-cm-config-mcli.yaml

@@ -4,7 +4,7 @@ source:
   ref: quick-create-profile
 replacement:
   mdbService: Cloud Manager
-  serviceName: "cloud-manager"
+  serviceOption: "--service cloud-manager"
 ---
 stepnum: 2
 source:

source/includes/steps-quick-start-config-mcli.yaml

@@ -1,32 +1,18 @@
 ---
-title: "Create a profile for the |service| project."
-stepnum: 0
-level: 4
-ref: quick-atlas-profile
-content: |
-  Run the following command to create the ``default`` profile.
-
-  .. code-block:: sh 
-
-     mongocli config
-
-  To learn more about the ``mongocli config`` command, see 
-  :ref:`mcli-config-command` or :ref:`mcli-configure`.
-
----
-title: "Create a profile for the {{mmsService}} project."
+title: "Create a profile for the {{service}} project."
 stepnum: 0
 level: 4
 ref: quick-create-profile
 content: |
-  Run the following command to create the ``default`` profile.
+  Run the following command to create the {+default-profile+}.
 
   .. code-block:: sh 
 
-     mongocli config --service {{serviceName}} --profile {{profileName}}
+     mongocli config {{serviceOption}}
 
-  To learn more about the ``mongocli config`` command, see 
-  :ref:`mcli-config-command` or :ref:`mcli-configure`.
+  .. seealso:
+     - :ref:`mcli-config-command`
+     - :ref:`mcli-configure`.
 
 ---
 title: "Set your credentials in your profile."

source/includes/steps-quick-start-om-config-mcli.yaml

@@ -4,7 +4,7 @@ source:
   ref: quick-create-profile
 replacement:
   mdbService: Ops Manager
-  serviceName: "ops-manager"
+  serviceOption: "--service ops-manager"
 ---
 stepnum: 2
 source:

source/quick-start.txt

@@ -101,11 +101,9 @@ To learn more about generating the |svc-api-key|, see:
       - MongoDB version: ``4.2`` 
       - Replica set members: ``3``
 
-      .. example::
+      .. code-block:: text 
 
-         .. code-block:: text 
-
-            mongocli atlas cluster create getStarted --provider AWS --region US_EAST_1 --tier M10 --diskSizeGB 10 --mdbVersion {+mdbVersion+} --members 3
+         mongocli atlas cluster create getStarted --provider AWS --region US_EAST_1 --tier M10 --diskSizeGB 10 --mdbVersion {+mdbVersion+} --members 3
 
       .. _quick-start-whitelist:
 
@@ -117,7 +115,8 @@ To learn more about generating the |svc-api-key|, see:
       addresses or |cidr| blocks to the project IP whitelist. 
 
       |service| supports specifying private IP addresses with VPC peered
-      connections. For more information, see :ref:`vpc-peering`.
+      connections. For more information, see
+      :atlas:`Set up a Network Peering Connection </security-vpc-peering/index.html>`.
 
       Run the following command to add entries to your whitelist.
       Replace the IP address with your connection IP address. 
@@ -230,14 +229,9 @@ To learn more about generating the |svc-api-key|, see:
 
       .. include:: /includes/quick-start-summary.rst
 
-      You can also connect to your cluster using the ``mongoURI``. For
-      example, run the following command to connect using the
-      ``mongoURI``. Replace ``mongoURI`` with the value of ``mongoURI``
-      in your ``cluster describe`` command output.
-
-      .. code-block:: sh 
-
-         mongo <mongoURI>
+      You can use the |mongo| shell connect to your cluster with the
+      ``srvAddress`` and appropriate :manual:`connection string options
+      </reference/connection-string/#connection-string-options>`.
 
    .. tab:: Cloud Manager
       :tabid: cloud-manager 
@@ -252,7 +246,8 @@ To learn more about generating the |svc-api-key|, see:
       Create a Cluster 
       ----------------
 
-      You can create a cluster on |cloud-short| using the {+mcli+}.
+      Use the :ref:`mcli-cm-cluster-create-command` command to create
+      a cluster in |cloud-short|.
 
       .. include:: /includes/quick-start-cm-om-create-cluster-intro.rst
       .. include:: /includes/steps/quick-start-cm-cluster-create.rst
@@ -351,7 +346,8 @@ To learn more about generating the |svc-api-key|, see:
       Create a Cluster 
       ----------------
 
-      You can create a cluster on |mms| using the {+mcli+}.
+      Use the :ref:`mcli-om-cluster-create-command` command to create
+      a cluster in |onprem|.
 
       .. include:: /includes/quick-start-cm-om-create-cluster-intro.rst
       .. include:: /includes/steps/quick-start-om-cluster-create.rst