DOCSP-11648 update for simplified output by default (#183)

* DOCSP-11648 update for simplified output by default

* DOCSP-11648 updates for copy review feedback

* DOCSP-11648 updates for tech review feedback

DOCSP-11648 self-review

Author: kanchana-mongodb

source/includes/command-output-intro.rst

@@ -1,3 +1,3 @@
-The command prints the following fields in |json| format to the terminal if
+The command prints the following fields in the specified format to the terminal if
 the command succeeds. If the command prints an error, see 
 :ref:`Troubleshooting <mcli-troubleshooting>` for recommended solutions.

source/includes/extracts-basic-options.yaml

@@ -1,7 +1,7 @@
 ref: fact-basic-options-output
 content: | 
-  Command output format. Value must be ``json``. If omitted, defaults to 
-  ``json``.
+  Command output format. Specify ``json`` for output in |json| format. If 
+  omitted, each command returns output in the default format.
 ---
 ref: fact-basic-options-profile
 content: | 

source/reference/atlas/alerts-ack.txt

@@ -100,7 +100,7 @@ forever.
             --projectId {PROJECT-ID} \
             --forever
 
-The previous command returns the following fields in |json| format to
+The previous command returns the following fields in the specified format to
 the terminal. To learn more about these fields, see
 :ref:`atlas-alerts-ack-output`.
 

source/reference/atlas/alerts-describe.txt

@@ -25,7 +25,7 @@ Syntax
 .. code-block:: text 
 
    mongocli atlas alert|alerts describe <alertID>
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <id-of-project> ]
 
@@ -43,7 +43,7 @@ Options
 Output 
 ------
 
-The command prints the following fields in |json| format 
+The command prints the following fields in the specified format 
 to the terminal if the command succeeds. If the command returns 
 errors, see :ref:`Troubleshooting <troubleshooting>` for 
 recommended solutions.
@@ -59,10 +59,10 @@ the {+default-profile+} to access |service|.
 
 .. code-block:: text
 
-   mongocli atlas alerts describe 5df914cf105eef21d36f8d01 \
+   mongocli atlas alerts describe 5df914cf105eef21d36f8d01 -o json \
    --projectId 5df90590f10fab5e33de2305
 
-The previous command prints the following fields in |json| format to 
+The previous command prints the following fields in the specified format to 
 the terminal. To learn more about these fields, see 
 :ref:`atlas-alerts-describe-output`.
 

source/reference/atlas/alerts-list.txt

@@ -26,7 +26,7 @@ Syntax
 
    mongocli atlas alert|alerts list|ls
         [ --limit <number-of-items-per-page> ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --page <page-number> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <id-of-project> ]
@@ -46,7 +46,7 @@ Options
 Output 
 ------
 
-For each alert, the command prints the following fields in |json| format 
+For each alert, the command prints the following fields in the specified format 
 to the terminal if the command succeeds. If the command returns 
 errors, see :ref:`Troubleshooting <troubleshooting>` for 
 recommended solutions.
@@ -63,9 +63,9 @@ the profile named ``myprofile`` for accessing |service|.
 .. code-block:: text
 
    mongocli atlas alerts list --projectId 5df90590f10fab5e33de2305 \
-   --profile myprofile
+    -o json --profile myprofile
 
-The previous command prints the following fields in |json| format to 
+The previous command prints the following fields in the specified format to 
 the terminal. To learn more about these fields, see 
 :ref:`atlas-alerts-list-output`.
 

source/reference/atlas/alerts-settings-create.txt

@@ -32,7 +32,7 @@ Syntax
         [ --matcherOperator <operator> ]
         [ --matcherValue <value> ]
         [ --notification* (notification flags) ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --projectId <id-of-project> ]
         [ --profile|-P <profile-name> ]
 
@@ -285,7 +285,7 @@ Output
 ------ 
 
 If the command succeeds, it prints the subset of the following fields to 
-the terminal in |json| format that describes the alert configuration. 
+the terminal in the specified format that describes the alert configuration. 
 If the command returns an error, see :ref:`Troubleshooting 
 <troubleshooting>` for recommended solutions.
 
@@ -305,9 +305,9 @@ project. It uses the {+default-profile+} to access the
    mongocli atlas alert settings create --event JOINED_GROUP --enabled \
    --notificationType USER --notificationEmailEnabled \
    --notificationUsername [email protected] \
-   --projectId 5df90590f10fab5e33de2305
+    -o json --projectId 5df90590f10fab5e33de2305
 
-The above command prints the following fields in |json| format to 
+The above command prints the following fields in the specified format to 
 the terminal. To learn more about these fields, see 
 :ref:`atlas-create-alerts-settings-output`.
 

source/reference/atlas/alerts-settings-delete.txt

@@ -32,7 +32,7 @@ Syntax
 
    mongocli atlas alerts settings|configs delete|rm|Delete|Remove <alert-id>
         [ --force ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-p <profile-name> ]
         [ --projectId <project-ID> ]
 

source/reference/atlas/alerts-settings-fields-type.txt

@@ -28,7 +28,7 @@ Syntax
 .. code-block:: text 
 
    mongocli atlas alert|alerts settings|config fields type|types
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
 
 .. include:: /includes/fact-command-line-help.rst
@@ -104,9 +104,9 @@ create or update an alert configuration. It uses the profile named
 
 .. code-block:: text
 
-   mongocli atlas alerts settings fields type --profile myprofile
+   mongocli atlas alerts settings fields type --profile myprofile -o json
 
-The previous command prints the following fields in |json| format to 
+The previous command prints the following fields in the specified format to 
 the terminal. To learn more about these fields, see 
 :ref:`atlas-alerts-settings-fields-type-output`.
 

source/reference/atlas/alerts-settings-update.txt

@@ -32,7 +32,7 @@ Syntax
         [ --matcherOperator <operator> ]
         [ --matcherValue <value> ]
         [ --notification* (notification flags) ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --projectId <id-of-project> ]
         [ --profile|-P <profile-name> ]
 
@@ -289,9 +289,9 @@ Options
 Output 
 ------ 
 
-If the command succeeds, it prints the subset of the following fields to 
-the terminal in |json| format that describes the alert configuration. 
-If the command returns an error, see :ref:`Troubleshooting 
+If the command succeeds, it prints the subset of the following fields, 
+which  describes the alert configuration, to the terminal in the specified 
+format. If the command returns an error, see :ref:`Troubleshooting 
 <troubleshooting>` for recommended solutions.
 
 .. include:: /includes/list-table-alert-settings-response-atlas.rst
@@ -310,9 +310,9 @@ project. It uses the {+default-profile+} to access the
    mongocli atlas alert settings update 5eaafc90da10757c5fc51e70 \ 
    --event JOINED_GROUP --enabled --notificationType USER \
    --notificationEmailEnabled --notificationUsername [email protected] \
-   --projectId 5df90590f10fab5e33de2305
+   --output json --projectId 5df90590f10fab5e33de2305
 
-The above command prints the following fields in |json| format to 
+The above command prints the following fields in the specified format to 
 the terminal. To learn more about these fields, see 
 :ref:`atlas-update-alerts-settings-output`.
 

source/reference/atlas/alerts-unack.txt

@@ -26,7 +26,7 @@ Syntax
    mongocli atlas alert|alerts unacknowledge|unack <alertID>
         [ --until <unacknowledgement time> ]
         [ --comment <optional comment> ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <id-of-project> ]
 
@@ -65,7 +65,7 @@ one month.
 
    mongocli atlas alerts unacknowledge {ALERT-ID} \
             --projectId {PROJECT-ID} \
-            --until 2020-06-04T20:24:26Z
+            --until 2020-06-04T20:24:26Z --output json
 
 The previous command returns the following |json| document. To learn
 more about the fields in the document, see

source/reference/atlas/backup-restore-list.txt

@@ -29,7 +29,7 @@ Syntax
    mongocli atlas backup|backups restore|restores list|ls 
         <cluster-name>
         [ --limit <items-per-page>]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --page <page-num> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <project-ID> ]
@@ -91,7 +91,7 @@ Options
 Output 
 ------
 
-The command prints the following fields in |json| format to the terminal
+The command prints the following fields in the specified format to the terminal
 if the command succeeds. If the command returns an error, see
 :ref:`Troubleshooting <troubleshooting>` for recommended solutions.
 
@@ -147,7 +147,7 @@ command to retrieve the Coninuous Backup restore jobs for the cluster
 
 .. code-block:: json 
 
-   mongocli atlas backup restore list Cluster0 
+   mongocli atlas backup restore list Cluster0 --output json
 
 The previous command prints the following fields to the terminal. To
 learn more about these fields, see

source/reference/atlas/backup-restore-start.txt

@@ -29,7 +29,7 @@ Syntax
 
    mongocli atlas backup restore start <restore-job-type>
         --clusterName <cluster-name>
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --oplogInc <oplog-Inc> ]
         [ --oplogTs <oplog-timestamp> ]
         [ --pointInTimeUTCMillis <pointInTime-UTC-ms> ]
@@ -262,7 +262,7 @@ of restore job:
 Output 
 ------
 
-The command prints the following fields in |json| format to the terminal
+The command prints the following fields in the specified format to the terminal
 if the command succeeds. If the command returns an error, see
 :ref:`Troubleshooting <troubleshooting>` for recommended solutions.
 
@@ -504,7 +504,8 @@ Example
                   --clusterName myDemo \
                   --snapshotId 5e7e00128f8ce03996a47179 \
                   --targetClusterId 5e2f56937a3e5a26326a5ee8 \
-                  --targetProjectId 1a2345b67c8e9a12f3456de7
+                  --targetProjectId 1a2345b67c8e9a12f3456de7 \
+                  --output json
 
       The previous command prints the following fields to the terminal.
       To learn more about these fields, see
@@ -557,7 +558,8 @@ Example
                   --clusterName myDemo \
                   --pointInTimeUTCMillis 1588523147 \
                   --targetClusterId 5e2f56937a3e5a26326a5ee8 \
-                  --targetProjectId 1a2345b67c8e9a12f3456de7
+                  --targetProjectId 1a2345b67c8e9a12f3456de7 \
+                  --output json
 
       The previous command prints the following fields to the terminal.
       To learn more about these fields, see
@@ -608,7 +610,8 @@ Example
 
          mongocli atlas backup restore start download \
                   --clusterName myDemo \
-                  --snapshotId 5e7e00128f8ce03996a47179 
+                  --snapshotId 5e7e00128f8ce03996a47179 \
+                  --output json
 
       The previous command prints the following fields to the
       terminal. To learn more about these fields, see

source/reference/atlas/backup-snapshots-list.txt

@@ -28,7 +28,7 @@ Syntax
 .. code-block:: text 
 
    mongocli atlas backup snapshots list|ls <cluster-name> 
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <project-ID> ]
 
@@ -77,7 +77,7 @@ Options
 Output 
 ------ 
 
-The command prints the following fields in |json| format to the terminal if 
+The command prints the following fields in the specified format to the terminal if 
 the command succeeds. If the command returns an error, see 
 :ref:`Troubleshooting <troubleshooting>` for recommended solutions.
 
@@ -96,10 +96,9 @@ command uses the {+default-profile+}, where the project ID and the
 .. code-block:: json 
    :copyable: false 
 
-   mongocli atlas backups snapshots list myDemo
+   mongocli atlas backups snapshots list myDemo --output json
 
-The command prints the following fields to the terminal. To learn more about these 
-fields, see :ref:`mcli-atlas-backup-snapshots-list-output`.
+The command prints the following fields to the terminal. To learn more about these fields, see :ref:`mcli-atlas-backup-snapshots-list-output`.
 
 .. code-block:: json 
    :copyable: false 

source/reference/atlas/cluster-create.txt

@@ -34,7 +34,7 @@ Syntax
         [ --file|-f <path-to-cluster-config-file> ]
         [ --mdbVersion <mongodb-version> ]
         [ --members|-m <number-of-members> ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <project-ID> ]
           --provider AWS|GCP|AZURE
@@ -258,7 +258,7 @@ which contains the public and private keys for accessing |service|.
 .. code-block:: sh
    :copyable: false
 
-   mongocli atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --members 3 --tier M2 --mdbVersion {+mdbVersion+} --diskSizeGB 10
+   mongocli atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --members 3 --tier M2 --mdbVersion {+mdbVersion+} --diskSizeGB 10 --output json
 
 The command returns the following to the terminal. To learn more about
 these fields, see :ref:`Output <atlas-cluster-create-output-fields>`.
@@ -338,8 +338,9 @@ and private keys for accessing |service|.
 
    mongocli atlas cluster create myCluster \
             --file cluster-config.json \
+            --output json \ 
             --projectId 5e2211c17a3e5a48f5497de3 \
-            --profile egAtlasProfile
+            --profile egAtlasProfile 
 
 The cluster configuration file contains the following settings:
 
@@ -465,7 +466,8 @@ keys for accessing |service|, as well as a default project ID.
     --members 3 \
     --tier M10 \
     --mdbVersion {+mdbVersion+} \
-    --diskSizeGB 10
+    --diskSizeGB 10 \
+    --output json
 
 The command returns the following to the terminal. To learn more about
 these fields, see :ref:`Output <atlas-cluster-create-output-fields>`.

source/reference/atlas/cluster-delete.txt

@@ -37,7 +37,7 @@ Syntax
 
    mongocli atlas cluster delete <cluster-name>
         [ --force ]
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         --projectId <project-ID>
 

source/reference/atlas/cluster-describe.txt

@@ -27,7 +27,7 @@ Syntax
    :copyable: false
 
    mongocli atlas cluster describe <cluster-name>
-        [ --output|-o json ]
+        [ --output|-o <output-format> ]
         [ --profile|-P <profile-name> ]
         [ --projectId <project-ID> ]
 
@@ -77,7 +77,7 @@ Options
 Output 
 ------
 
-The command prints the following fields in |json| format to the 
+The command prints the following fields in the specified format to the 
 terminal if the command succeeds. If the command returns errors, 
 see :ref:`Troubleshooting <troubleshooting>` for recommended solutions.
 
@@ -96,7 +96,7 @@ that contains the cluster.
 .. code-block:: text
    :copyable: false
 
-   mongocli atlas cluster describe myCluster --projectId 5e2211c17a3e5a48f5497de3
+   mongocli atlas cluster describe myCluster --projectId 5e2211c17a3e5a48f5497de3 --output json
 
 The example command prints the following fields to the terminal. To learn 
 more about these fields, see :ref:`Output <cluster-describe-output>`.