DOCSP-34286 -- incorporate internal review feedback

Author: jvincent-mongodb

source/reference/json/file-options-online-archive.txt

@@ -10,23 +10,25 @@ Online Archive Configuration File
    :depth: 1
    :class: singlecol
 
-You can use an Online Archive configuration file to specify the required 
-settings for creating and updating an Online Archive. This archive stores 
-data from one cluster within one project. To use this resource, the 
-requesting API Key must have the Project Data Access Admin role.
+You can use a configuration file to specify the required  
+settings for creating and updating an online archive using the 
+{+atlas-cli+}. The {+atlas-cli+} accepts ``.json`` online archive 
+configuration files.
 
 Use the following resources to:
 
-- Learn the required settings you can specify in the Online Archive 
-  configuration file.
+- Learn the :ref:`required settings <required-oa-settings>` you 
+  can specify in the online archive 
 
 - View and copy sample configuration files.
 
+.. _required-oa-settings:
+
 Required Online Archive Create and Update Settings
 --------------------------------------------------
 
-|service| requires the following settings to create an Online Archive with
-the {+atlas-cli+}. You must specify these Online Archive settings either
+|service| requires the following settings to create an online archive with
+the {+atlas-cli+}. You must specify these online archive settings either
 in the configuration file or as flags in the command:
 
 .. list-table:: 
@@ -39,21 +41,20 @@ in the configuration file or as flags in the command:
 
    * - ``groupId``
      - string
-     - Unique identifier for your project. Your group id is the same 
-       as your project id. For existing groups, your group/project id 
+     - Unique identifier for your project. Your ``groupId`` is the same 
+       as your ``projectId``. For existing groups, your group/project id 
        remains the same. The resource and corresponding 
        endpoints use the term groups.
 
    * - ``archiveID``
      - string
      - Unique 24-hexadecimal digit string that identifies 
-       the online archive to update. This param is required for updating an
-       existing Online Archive.
+       the online archive to update.
 
    * - ``clusterName``
      - string
      - Human-readable label that identifies the cluster that contains 
-       the collection for which you want to create one online archive.
+       the collection for which you want to create or update one online archive.
 
    * - ``collName``
      - string
@@ -73,19 +74,27 @@ For a full list of available settings, see the API documentation for
 
 Example Online Archive Create Command
 -------------------------------------
-After you create the file, run the command to create the Online Archive.
+To create an online archive configuration, specify the ``--file`` option 
+and the path to the file. The following example creates an 
+online archive by using a configuration file named 
+``online-archive-create-config.json``:
 
 .. code-block::
 
-    atlas clusters onlineArchive create --file online-archive-create.json --output json
+    atlas clusters onlineArchive create --file online-archive-create-config.json --output json
 
 Example Online Archive Update Command
 -------------------------------------
-After you create the file, run the command to update the Online Archive.
+To update an online archive configuration, specify the ``--file`` option 
+and the path to the file. The following example updates an 
+online archive by using a configuration file named 
+``online-archive-update-config.json``:
 
 .. code-block::
 
-    atlas clusters onlineArchive update --file online-archive-update.json --output json
+    atlas clusters onlineArchive update --file online-archive-update-config.json --output json
+
+.. _example-oa-config-file:
 
 Example Online Archive Create Configuration File
 ------------------------------------------------