DOCSP-41588: Update Sync Settings page with UI changes (#811)

* Update Sync Settings with UI changes

* Update screenshots for Migrate page

* Update screenshot settings and add ref

* Change images to figures

* Remove includes

* Apply suggestions from code review

Co-authored-by: Kyle Rollins <[email protected]>

---------

Co-authored-by: Kyle Rollins <[email protected]>

Author: cbullinger

snooty.toml

@@ -83,6 +83,7 @@ name-char-limit = "57"
 request-timeout-time = "300 seconds"
 sync-default-message-size-limit = "20 MB"
 sync-inactive-app-pause-time = "30 days"
+sync-min-mongo-version-required = "5.0"
 user-session-expiration-time = "30 minutes"
 min-user-session-refresh-token-expiration-time = "30 minutes"
 max-user-session-refresh-token-expiration-time = "5 years"

source/images/begin-migration.png

@@ -1,5 +1,5 @@
-.. note:: MongoDB Version 5.0 or Higher Required
-   
-   Atlas Device Sync requires an Atlas cluster running MongoDB version 5.0 or later.
-   When setting up your cluster, select :guilabel:`MongoDB 5.0` (or a later version)
+.. note:: MongoDB Version {+sync-min-mongo-version-required+} or Higher Required
+
+   Atlas Device Sync requires an Atlas cluster running MongoDB version {+sync-min-mongo-version-required+} or later.
+   When setting up your cluster, select the version
    from the dropdown menu under :guilabel:`Additional Settings`.

source/images/cancel-migration.png

@@ -0,0 +1,2 @@
+From the App Services UI, click :guilabel:`Device Sync` in the left
+navigation menu. The :guilabel:`Dashboard` tab displays by default.

source/images/commit-migration.png

@@ -1,5 +1,9 @@
-.. note:: Flexible Sync Prerequisites
+.. note:: Data Source Requirements for Device Sync
 
-   Enabling Flexible Sync in Your App Services Application requires a
-   non-sharded MongoDB Atlas cluster running :manual:`MongoDB 5.0 or greater
-   </release-notes/>`
+   To enable Device Sync, your App Services App must have at least one linked
+   data source that meets the following requirements:
+
+   - A non-sharded MongoDB Atlas cluster running
+     :manual:`MongoDB {+sync-min-mongo-version-required+} or later </release-notes/>`.
+   - Cluster *cannot* be a serverless instance or {+adf-instance+}. Refer to
+     :ref:`<data-source-limitations>`.

source/images/confirm-migration-commit.png

@@ -116,10 +116,7 @@ synced cluster.
 To learn more about Atlas Device Sync and how it interacts with your app's data
 sources, see :ref:`Atlas Device Sync <sync>`.
 
-.. note:: Version 4.4 Required for Sync
-   
-   In order to use Atlas Device Sync, your cluster must run MongoDB version
-   4.4 or newer.
+.. include:: /includes/note-flexible-sync-prerequisite.rst
 
 React to Changing Data
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -154,10 +151,10 @@ You can configure a new linked data source in the App Services UI or by defining
 and pushing a configuration file with the {+cli-ref+} or GitHub deployment:
 
 .. tabs-realm-admin-interfaces::
-   
+
    .. tab::
       :tabid: ui
-      
+
       .. procedure::
 
          .. step:: Navigate to the Data Source Management Screen
@@ -216,10 +213,10 @@ and pushing a configuration file with the {+cli-ref+} or GitHub deployment:
             process of linking to the data source, which could take up to five
             minutes.
 
-   
+
    .. tab::
       :tabid: cli
-      
+
       .. procedure::
 
          .. step:: Pull the Latest Version of Your App
@@ -311,6 +308,7 @@ and pushing a configuration file with the {+cli-ref+} or GitHub deployment:
 
                {+cli-bin+} push --remote="<Your App ID>"
 
+.. _data-source-limitations:
 
 Data Source Limitations
 -----------------------