DOCSP-41323 made behavior page (#356)

Author: sonderdonk-mdb

snooty.toml

@@ -21,7 +21,8 @@ toc_landing_pages = ["/quickstart",
                      "/release-notes/release-notes",
                      "/faq",
                      "/reference/collection-level-filtering",
-                     "/reference/verification"
+                     "/reference/verification",
+                     "/reference/mongosync"
                     ]
 
 [constants]

source/about-mongosync.txt

@@ -12,9 +12,9 @@ About ``mongosync``
    :depth: 2
    :class: singlecol
 
-The ``mongosync`` binary is the primary process used in {+c2c-product-name+}. 
-``mongosync`` migrates data from a source cluster to a destination cluster and 
-keeps the clusters in continuous sync until you 
+The :ref:`mongosync <c2c-mongosync>` binary is the primary process used in 
+{+c2c-product-name+}. ``mongosync`` migrates data from a source cluster to a 
+destination cluster and keeps the clusters in continuous sync until you 
 :ref:`finalize <c2c-about-finalizing>` the sync. 
 
 You can use ``mongosync`` to create 
@@ -162,5 +162,6 @@ Learn More
 
 To learn more about ``mongosync``, see:
 
-- :ref:`mongosync <c2c-mongosync>`
-- :ref:`mongosync States <c2c-states>`
+- :ref:`c2c-mongosync`
+- :ref:`mongosync Behavior <c2c-mongosync-behavior>`
+- :ref:`c2c-limitations`

source/includes/fact-connection-strings-atlas.rst

@@ -1,4 +1,4 @@
-:ref:`mongosync <c2c-mongosync>` uses a :ref:`MongoDB URI
+``mongosync`` uses a :ref:`MongoDB URI
 connection string <mongodb-uri>` to connect Atlas clusters:
 
 - The SRV connection scheme has the form:

source/includes/fact-connection-strings-onprem.rst

@@ -1,4 +1,4 @@
-:ref:`mongosync <c2c-mongosync>` uses a :ref:`MongoDB URI
+``mongosync`` uses a :ref:`MongoDB URI
 connection string <mongodb-uri>` to connect self-managed clusters:
 
 - The SRV connection scheme has the form:

source/includes/fact-connection-strings.rst

@@ -1,4 +1,4 @@
-:ref:`mongosync <c2c-mongosync>` uses a :ref:`MongoDB URI
+``mongosync`` uses a :ref:`MongoDB URI
 connection string <mongodb-uri>` to connect clusters:
 
 - The SRV connection scheme has the form:

source/index.txt

@@ -21,13 +21,13 @@ and data residency compliance.
 In addition to continuous data synchronization, ``mongosync`` can also
 facilitate a one time data migration between clusters. 
 
-For an overview of ``mongosync``, see :ref:`about-mongosync`.
+For an overview of the ``mongosync`` process, see :ref:`about-mongosync`.
 
 To get started with ``mongosync``, refer to the :ref:`Quick Start Guide
 <c2c-quickstart>`. For more detailed information, refer to the
 :ref:`c2c-install` or :ref:`c2c-connecting` page that best fits your
 situation. See also the :ref:`c2c-limitations` page for important
-restrictions.
+restrictions and the :ref:`c2c-mongosync-behavior` page for behavior information.
 
 .. include:: /includes/limitations-warning
 

source/quickstart.txt

@@ -21,8 +21,7 @@ Overview
 
 {+c2c-full-product-name+} connects MongoDB clusters and provides a way
 to synchronize data between them. The tool that makes the connection is
-:ref:`c2c-mongosync`. This page provides a short introduction to help
-you get started with {+c2c-product-name+}. For more details, please see
+:ref:`mongosync <c2c-mongosync>`. For more details, please see
 the rest of the {+c2c-product-name+} documentation.
 
 ``mongosync`` syncs data between two clusters. 
@@ -119,7 +118,7 @@ Setup
 
    .. step:: Download and install ``mongosync``
 
-      :ref:`c2c-mongosync` is the tool that connects the source and
+      ``mongosync`` is the tool that connects the source and
       destination clusters. You can host ``mongosync`` on its own
       hardware, ``mongosync`` does not have to run on the hardware that
       hosts your MongodDB clusters.
@@ -171,7 +170,7 @@ Connect the Clusters
 
    .. step:: Initialize mongosync
 
-      :program:`mongosync` must create an initial connection to the source and
+      ``mongosync`` must create an initial connection to the source and
       destination clusters before it can start to sync data. To create the initial
       connection, issue the following command with your connection
       strings on a single line (the command is
@@ -295,7 +294,7 @@ Synchronization Notes
 
 - The default port for the HTTP API is ``27182``.  Use the ``--port``
   option with ``mongosync`` to :ref:`configure another port
-  <c2c-mongosync>`
+  <c2c-config>`.
 
 - ``mongosync`` can swap the source and destination clusters to enable
   :ref:`reverse synchronization <c2c-api-reverse>`.  

source/reference.txt

@@ -3,11 +3,11 @@ Reference
 =========
 
 :ref:`c2c-mongosync`
-   The options and behavior in {+c2c-product-name+}.
+   Overview of ``mongosync`` binary.
 
 :ref:`c2c-config`
-   Configure :program:`mongosync` instances at startup using a
-   configuration file.
+   Configure ``mongosync`` instances at startup 
+   using a configuration file.
 
 :ref:`c2c-api`
    API endpoints to interact with ``mongosync``. 
@@ -50,7 +50,7 @@ Reference
 
 .. toctree::
    :titlesonly:
-
+   
    /reference/mongosync
    /reference/configuration
    /reference/api

source/reference/configuration.txt

@@ -12,16 +12,16 @@ Configuration
    :depth: 2
    :class: singlecol
 
-You can configure :program:`mongosync` instances at startup using a
-configuration file.  The configuration file contains settings that are
+You can configure :ref:`mongosync <c2c-mongosync>` instances at startup 
+using a configuration file.  The configuration file contains settings that are
 the equivalent of ``mongosync`` command line options.
 
 Configuration File
 ==================
 
-Most :program:`mongosync` command line options can be written to a YAML
-file. The configuration file specifies values for each setting using
-YAML format. 
+You can write most ``mongosync`` 
+:ref:`command line options <c2c-cli-options>` to a YAML file. The 
+configuration file specifies values for each setting using YAML format. 
 
 For example:
 

source/reference/cutover-process.txt

@@ -14,7 +14,7 @@ Finalize Cutover Process
 
 You can finalize a migration and transfer your application
 workload from the source to the destination cluster using the
-``mongosync`` cutover process. 
+:ref:`mongosync <c2c-mongosync>` cutover process. 
 
 .. note::
 
@@ -29,7 +29,8 @@ Steps
 .. procedure:: 
    :style: normal 
 
-   .. step:: Verify the status of the :program:`mongosync` process. 
+   .. step:: Verify the status of the ``mongosync`` 
+      process. 
 
       Call the :ref:`progress <c2c-api-progress>` endpoint to determine
       the status of ``mongosync`` before starting the cutover process.