DOCSP-41456: Rename Realm and clarify terminology on Device Sync landing page (#813)

* Rename Realm and clarify terminology

* Apply Dachary feedback

Author: cbullinger

source/sync.txt

@@ -8,16 +8,17 @@
 Atlas Device Sync
 =================
 
-.. meta:: 
+.. meta::
    :description: Atlas Device Sync is a cloud service that syncs data seamlessly between local devices and Atlas.
+   :keywords: Realm, C++ SDK, Flutter SDK, Java SDK, Kotlin SDK, .NET SDK, Node.js SDK, React Native SDK, Swift SDK, mobile app development, MongoDB mobile
 
 .. toctree::
    :titlesonly:
    :hidden:
-   
+
    Get Started </sync/get-started>
    App Builder's Resources </sync/app-builder>
-   Configure and Update Your Data Model </sync/configure-your-data-model>
+   Define and Update Your Data Model </sync/configure-your-data-model>
    Configure Sync </sync/configure-device-sync>
    Handle Errors </sync/error-handling>
    Go to Production with Sync </sync/go-to-production>
@@ -32,12 +33,12 @@ Atlas Device Sync
    can be intermittent, so you write data locally on the device first. A
    background process then synchronizes the data to the cloud and resolves any
    conflicting writes.
- 
+
    Atlas Device Sync provides all of the above, so you can build better apps faster.
 
-   Watch our `Intro to Atlas Device Sync 
-   <https://learn.mongodb.com/learn/course/intro-to-atlas-device-sync/learning-byte/learn>`__ 
-   Learning Byte to learn more.  
+   Watch our `Intro to Atlas Device Sync
+   <https://learn.mongodb.com/learn/course/intro-to-atlas-device-sync/learning-byte/learn>`__
+   Learning Byte to learn more.
 
    .. button:: Start Building with a Template App
       :uri: https://www.mongodb.com/realm/register?tck=docs_CTA_app_services
@@ -56,12 +57,12 @@ Key Features
    :style: compact
 
    .. card::
-      :headline: Realm in the Front, MongoDB in the Back
+      :headline: Atlas Device SDK in the Front, MongoDB in the Back
       :icon: /images/icons/General_FEATURES_IntelligentEdge3x.png
       :icon-alt: An icon depicting a mobile phone connecting with the cloud
 
-      Atlas Device Sync is a bridge between client apps using the :realm:`Realm SDKs </>`
-      and a MongoDB instance running in Atlas. Realm is a lightweight database
+      Atlas Device Sync bridges client apps using the :realm:`Atlas Device SDK </>`
+      and a MongoDB instance running in Atlas. The lightweight device database is
       optimized for mobile development.
 
    .. card::
@@ -78,7 +79,7 @@ Key Features
       :icon: /images/icons/Technical_REALM_Offline3x.png
       :icon-alt: An icon depicting network loss
 
-      Realm Database and Device Sync seamlessly handle intermittent
+      Atlas Device SDK and Device Sync seamlessly handle intermittent
       connectivity so users can continue using your app regardless of their
       current network status.
 
@@ -99,10 +100,10 @@ Get Started
       :icon: /images/icons/Technical_REALM_iOSAndriodCrossPlatform3x.png
       :icon-alt: An icon depicting two mobile devices synchronizing data between each other
 
-      The best way to start using Device Sync is with a template starter app.
-      In the Atlas App Services UI, under the :guilabel:`App Services` tab, you can select a
-      template. Atlas configures a backend instance and gives you the
-      frontend code for a selection of platforms.
+      The best way get started with Device Sync is with a template app.
+      From the Atlas UI, select the :guilabel:`App Services` tab, and select
+      from the provided templates. Atlas configures a backend instance and
+      gives you the frontend code for a selection of platforms.
 
    .. card::
       :headline: Follow a Device Sync Tutorial
@@ -122,11 +123,11 @@ Explore the Device Sync Documentation
 
 .. procedure::
 
-   .. step:: Maintain Data Integrity with Schemas
+   .. step:: Maintain Data Integrity with Your Data Model
 
-      Define your application data model with standard schemas that you can use
-      to validate data and generate language-specific classes. Read the
-      :ref:`sync-schema-overview` to get oriented.
+      Define your application data model directly in your code or with
+      server-side JSON schemas that you can use to generate language-specific
+      classes. Read the :ref:`sync-schema-overview` to get oriented.
 
    .. step:: Configure & Enable Device Sync
 
@@ -143,9 +144,9 @@ Explore the Device Sync Documentation
 
    .. step:: Handle Errors
 
-      Develop a robust app that can handle schema changes and data recovery
+      Develop a robust app that can handle data model changes and data recovery
       scenarios with the :ref:`client-resets` documentation. Troubleshoot other
-      errors and edge cases with the :ref:`sync-errors` reference. 
+      errors and edge cases with the :ref:`sync-errors` reference.
 
    .. step:: Go to Production
 
@@ -169,11 +170,11 @@ End-to-End Security
       :icon: /images/icons/Technical_REALM_Mobile3x.png
       :icon-alt: An icon depicting a mobile app
 
-      Encrypt sensitive data in Realm Database files with the encryption APIs.
+      Encrypt sensitive data in synced database files with the encryption APIs.
 
       Built-in user authentication providers include anonymous, email/password,
       API key, Custom Function, Custom JWT, Facebook, Google, and Apple.
-      
+
    .. card::
       :headline: In Flight
       :icon: /images/icons/General_CLOUD_Transfer3x.png

source/sync/get-started.txt

@@ -4,11 +4,12 @@
 Get Started with Atlas Device Sync
 ==================================
 
-.. meta:: 
-   :description: Learn how to get started with Atlas Device Sync in this high-level overview.
+.. meta::
+   :description: Get started using Atlas Device Sync with this high-level overview.
+   :keywords: Realm, C++ SDK, Flutter SDK, Java SDK, Kotlin SDK, .NET SDK, Node.js SDK, React Native SDK, Swift SDK, mobile app development, MongoDB mobile
 
 .. facet::
-   :name: genre 
+   :name: genre
    :values: reference
 
 .. contents:: On this page
@@ -17,14 +18,13 @@ Get Started with Atlas Device Sync
    :depth: 2
    :class: singlecol
 
-To sync data across devices, you :ref:`enable Device Sync <enable-sync>` for your
-App and then use the sync-related methods and properties in the SDKs.
+To sync data across devices, :ref:`enable Device Sync <enable-sync>`, then use the sync-related methods and properties in the
+:ref:`Atlas Device SDK <realm-sdks>`.
 
 .. tip:: Check out the tutorial
-   
-   If you prefer to learn by example, check out the App Services 
-   `tutorial <https://www.mongodb.com/docs/realm/tutorial/>`_, which describes
-   how to build a synced to-do list application with clients for common 
+
+   If you prefer to learn by example, check out the Device Sync
+   :ref:`tutorial <app-services-get-started-tutorials>`, which uses a synced to-do list application with clients for common
    platforms that App Services supports.
 
 Before You Start
@@ -33,13 +33,14 @@ Before You Start
 - If you don't already have one, `sign up for a free MongoDB Atlas account
   <https://www.mongodb.com/cloud/atlas/register?tck=docs_realm>`__.
 
-- Flexible Sync requires MongoDB version 5.0 or later. You can use a free shared
+- Device Sync requires an Atlas cluster running MongoDB version {+sync-min-mongo-version-required+} or
+  later. You can use a free shared
   M0 cluster to explore and develop your app. We recommend that you use a
   dedicated tier cluster (M10 and above) for production applications. You cannot
   use sync with a :ref:`serverless instance <serverless-caveats>` or
   :ref:`{+adf-instance+} <data-federation-caveats>`.
-  
-- If you don't already have one, :ref:`create a new App
+
+- If you don't already have one, :ref:`create a new App Services App
   <create-app>` linked to your Atlas cluster.
 
 Configure Your Data Model
@@ -48,14 +49,16 @@ Configure Your Data Model
 Choose an SDK
 ~~~~~~~~~~~~~
 
-Realm is an object database optimized for mobile use cases. The
-:ref:`Realm SDKs <realm-sdks>`, available for multiple languages and
-platforms, include everything you need to work with synced "realms" in your
-client code. You can use multiple SDKs to work with the same set of synced data
+:ref:`Atlas Device SDK <realm-sdks>` wraps Realm Core Database, an object
+database optimized for mobile and edge use cases. The SDK, available for multiple languages
+and
+platforms, includes everything you need to work with synced databases in your
+client code. You can use multiple SDK languages to work with the same set of synced data
 across devices and platforms.
 
-This guide focuses on configuring sync with an SDK. For in-depth documentation
-that includes details on how to install and use the Realm SDKs more generally,
+This guide focuses on configuring Device Sync with the SDK. For in-depth documentation
+that includes details on how to install and use the Atlas Device SDK more
+generally,
 check out the SDK docs:
 
 - :ref:`C++ SDK <cpp-intro>`
@@ -67,56 +70,55 @@ check out the SDK docs:
 - :ref:`React Native SDK <react-native-intro>`
 - :ref:`Swift SDK <ios-intro>`
 
-.. note::
+.. note:: Using Device Sync with the Realm JS WebAssembly SDK
 
-   The Realm Web SDK does not currently support Realm Database or Atlas Device Sync.
-   However, you can query the same data in an Atlas cluster using 
+   For more information on building realtime web apps for the browser with the
+   Realm Database API and Atlas Device Sync, check out :ref:`<web-sync>`.
+   Or you can query the same data in an Atlas cluster using
    :ref:`MongoDB Data Access <web-mongodb-data-access>`.
 
 Define Data Model
 ~~~~~~~~~~~~~~~~~
 
-A synced realm uses object models that you define to determine the type of
-objects in the realm. Additionally, Sync requires a server-side document schema
-for each synced object type so that App Services can translate and apply changes
-between synced realms and MongoDB Atlas.
+A synced database uses object models that you define to determine the type of
+objects in the database. Additionally, Sync requires a server-side document schema
+for each synced object type so the server can translate and apply changes
+between synced databases and MongoDB Atlas.
 
 To define your synced object models, do one of the following for each object
 type:
 
 - **Sync object models from an SDK:** In :ref:`Development Mode
-  <development-mode>`, App Services automatically generates a document schema
+  <development-mode>`, you can automatically generate a document schema
   for each synced object type and assigns that schema to a collection in the
   linked cluster with the same name as the object type. Development mode lets
   you configure your synced data model from a client application using the same
   object models and code that you use in your production app. This is useful if
   you prefer a client-first approach that uses idiomatic object models in your
   preferred programming language.
-  
-  For a walkthrough of how to turn on Development Mode, see :ref:`Enable
-  Development Mode <development-mode>`.
-
-- **Generate object models from a document schema:** App Services can automatically
-  generate language-specific object models that you can use in your client
-  applications. The generated models match the document schemas defined for your
-  app's synced cluster. You can define these schemas manually or App Services can
-  sample existing data in the cluster to create them automatically. This is
-  useful if you prefer a server-first approach and/or plan to build apps with
-  multiple SDKs.
-  
-  For a walkthrough of how to generate your object models based on server-side
-  document schemas, see :ref:`Generate SDK Object Models
-  <generate-sdk-object-models>`.
-  
+
+  To get started, check out :ref:`create-sync-schema`.
+
+- **Generate object models from a document schema:** If you already have data in
+  Atlas, you can automatically generate language-specific object models that
+  match the document schemas defined for your app's synced cluster. You can
+  define these schemas manually or App Services can sample existing data in the
+  cluster to create them automatically. This is useful if you prefer a
+  server-first approach or plan to build apps with multiple SDKs.
+
+  For a walkthrough of how to generate object models that you can use in your
+  client applications, see
+  :ref:`Generate SDK Object Models<generate-sdk-object-models>`.
+
   Once you have the generated object models, you can copy them directly into
   your client application and use them the same way you would any regular object
   or struct in your preferred programming language.
 
 Define Data Access Patterns
 ---------------------------
 
-Once you have decided on your app's data model, you can define a data access 
-pattern and access rules for your app's data. 
+Once you have decided on your app's data model, you can define a data access
+pattern and access rules for your app's data.
 
 Client applications can query the queryable fields of a document to determine
 which objects to sync. Then, App Services applies rules and default roles to
@@ -125,11 +127,11 @@ determine whether users can read or write the objects that match the query.
 Define Data Access Rules
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-Data access rules determine which data to sync, as well as each user's 
-ability to read and write data. Rules are closely linked to your app's data 
+Data access rules determine which data to sync, as well as each user's
+ability to read and write data. Rules are closely linked to your app's data
 model.
 
-With Flexible Sync, you specify which data to sync through queries for matching
+With Device Sync, you specify which data to sync through queries for matching
 objects in a client application. App Services then evaluates :ref:`roles and
 rules <flexible-sync-roles>` to determine which of those matching objects a user
 can read and write.
@@ -139,11 +141,11 @@ write permissions when more specific roles do not apply. Default roles apply to
 all collections an App can access, but you can restrict a role to a specific
 collection by specifying the collection name.
 
-Enable Sync
-~~~~~~~~~~~
+Configure Sync
+~~~~~~~~~~~~~~~
 
-When you enable Sync, you specify how clients can access data in your App.
-For a walkthrough of how to turn on sync, refer to :ref:`enable-sync`.
+Device Sync lets you specify how clients can access data in your App.
+For a walkthrough of how to enable and configure Sync, refer to :ref:`enable-sync`.
 
 Optimize Sync Data Usage
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -165,22 +167,23 @@ our guide to :ref:`Optimize Device Sync Atlas Usage
 Create Queries in Your Client Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-With Flexible Sync enabled, you can start creating queries from your client
-application. 
+With Device Sync enabled, you can start creating queries from your client
+application.
 
-The Realm SDKs provide methods to create, update, and remove queries from the
+The Atlas Device SDK provide methods to create, update, and remove queries from the
 client application. The SDKs use **subscriptions** to maintain those queries on
 the client side. Through these subscriptions, your applications sync objects
 with the backend app and can watch for and react to changes.
 
-To create queries from your client application, refer to the Realm SDK documentation:
+To create queries from your client application, refer to the Atlas Device SDK
+documentation in your preferred programming language:
 
-- :ref:`Flexible Sync - Flutter SDK <flutter-sync>`
-- :ref:`Flexible Sync - Java SDK<java-flexible-sync>`
-- :ref:`Flexible Sync - Kotlin SDK <kotlin-subscriptions>`
-- :ref:`Flexible Sync - .NET SDK <dotnet-flexible-sync>`
-- :ref:`Flexible Sync - Node.js SDK <node-flexible-sync>`
-- :ref:`Flexible Sync - React Native SDK <react-native-flexible-sync>`
-- :ref:`Flexible Sync - Swift SDK <ios-flexible-sync>`
+- :ref:`Flutter SDK <flutter-sync>`
+- :ref:`Java SDK<java-flexible-sync>`
+- :ref:`Kotlin SDK <kotlin-subscriptions>`
+- :ref:`.NET SDK <dotnet-flexible-sync>`
+- :ref:`Node.js SDK <node-flexible-sync>`
+- :ref:`React Native SDK <react-native-flexible-sync>`
+- :ref:`Swift SDK <ios-flexible-sync>`
 
 .. include:: /includes/important-sync-ignores-custom-collation.rst