DOCSP-34286 -- incorporate interal review feedback

Author: jvincent-mongodb

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

@@ -20,16 +20,16 @@ Use the following resources to:
 - Learn the :ref:`required settings <required-oa-settings>` you 
   can specify in the online archive 
 
-- View and copy sample configuration files.
+- View and copy :ref:`sample configuration files <example-oa-config-file>`.
 
 .. _required-oa-settings:
 
-Required Online Archive Create and Update Settings
---------------------------------------------------
+Online Archive Settings
+-----------------------
 
-|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:
+You can specify the following settings to create or 
+update an online archive either in the configuration 
+file or as flags in the command:
 
 .. list-table:: 
    :header-rows: 1 
@@ -69,8 +69,23 @@ in the configuration file or as flags in the command:
      - Human-readable label of the database that 
        contains the collection that contains the online archive.
 
-For a full list of available settings, see the API documentation for 
-:oas-atlas-op:`Create One Online Archive<>`.
+For detailed descriptions and a full list of available settings,
+see the request body schema in the API specification:
+- :oas-atlas-op:`Create One Online Archive </createOnlineArchive>`
+- :oas-atlas-op:`Update One Online Archive </updateOnlineArchive>`
+
+.. _example-oa-config-file:
+
+Example Online Archive Create Configuration File
+------------------------------------------------
+
+.. literalinclude:: /includes/online-archive-create.json
+
+
+Example Online Archive Update Configuration File
+------------------------------------------------
+
+.. literalinclude:: /includes/online-archive-update.json
 
 Example Online Archive Create Command
 -------------------------------------
@@ -94,15 +109,5 @@ online archive by using a configuration file named
 
     atlas clusters onlineArchive update --file online-archive-update-config.json --output json
 
-.. _example-oa-config-file:
-
-Example Online Archive Create Configuration File
-------------------------------------------------
 
-.. literalinclude:: /includes/online-archive-create.json
 
-
-Example Online Archive Update Configuration File
-------------------------------------------------
-
-.. literalinclude:: /includes/online-archive-update.json