Update landing page and add missing placeholder pages

dacharyc · dacharyc · commit d308023723b4 · 2024-05-13T14:47:54.000-04:00
diff --git a/source/index.txt b/source/index.txt
@@ -64,89 +64,184 @@ SDK is language-idiomatic and includes:
   :ref:`Authentication <users-and-authentication>`, :ref:`Functions <functions>`,
   :ref:`Triggers <trigger-types>`, and more.
 
+.. kicker:: Learning Paths
+
+Get Started with the Swift SDK
+------------------------------
+
 .. card-group::
+   :columns: 3
    :style: extra-compact
-   :columns: 2
 
    .. card::
-      :cta: Learn more about Atlas App Services
-      :headline: Atlas App Services
-      :icon: /images/icons/realm.svg
-      :url: https://www.mongodb.com/docs/atlas/app-services/
+      :headline: Quick Start
+      :cta: See Code Examples
+      :url: https://https://preview-mongodbdacharyc.gatsbyjs.io/realm/scaffold-consolidated-sdk-toc/sdk/quick-start
+      :icon: /images/icons/branding_2022/Technical_ATLAS_Functions3x.png
+      :icon-alt: Functions Icon
 
-      Discover how to sync data, define permissions, and connect to other services, including MongoDB Atlas.
+      Minimal-explanation code examples of how to work with the Swift SDK. 
+      Write to the device database, and sync with other devices.
 
    .. card::
-      :headline: Swift SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/swift/
-      :icon: /images/icons/swift_sdk.svg
-      :icon-alt: Swift SDK icon
+      :headline: Working Example App
+      :cta: Explore an Example App
+      :url: https://www.mongodb.com/docs/atlas/app-services/template-apps/
+      :icon: /images/icons/branding_2022/Technical_REALM_Mobile3x.png
+      :icon-alt: Realm Mobile Icon
 
-      Build applications in Swift or Objective-C for Apple platforms, including iOS, macOS, watchOS, and tvOS.
+      Learn from example by dissecting a working mobile client app that
+      uses Atlas Device SDK.
 
    .. card::
-      :headline: Kotlin SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/kotlin/
-      :icon: /images/icons/kotlin_sdk.svg
-      :icon-alt: Kotlin SDK icon
+      :headline: Guided Tutorial
+      :cta: Follow the Tutorial
+      :url: https://www.mongodb.com/docs/atlas/app-services/tutorials/
+      :icon: /images/icons/branding_2022/General_CONTENT_Tutorial3x.png
+      :icon-alt: Tutorial Icon
 
-      Build cross-platform applications for Android, iOS, and macOS with Kotlin Multiplatform (KMP).
+      Follow a guided tutorial to learn how to adapt the example app to
+      create your own working app.
 
-   .. card::
-      :headline: .NET SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/dotnet/
-      :icon: /images/icons/dot_net_sdk.svg
-      :icon-alt: .NET SDK icon
+.. kicker:: What You Can Do
 
-      Build applications that use C# and the .NET platform, including MAUI, 
-      Xamarin, native Windows applications, and Unity projects.
+Develop Apps with the SDK
+--------------------------
 
-   .. card::
-      :headline: Node.js SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/node/
-      :icon: /images/icons/node_js_sdk.svg
-      :icon-alt: Node.JS SDK icon
+Use the SDK's open-source database - Realm - as an object store on the device. 
+Use Device Sync to keep data in sync with your MongoDB Atlas cluster and 
+other clients.
 
-      Use the Node.js SDK to build server and IoT applications in JavaScript or TypeScript.
+.. tabs::
 
-   .. card::
-      :headline: React Native SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/react-native/
-      :icon: /images/icons/react_native_sdk.svg
-      :icon-alt: React SDK icon
+   .. tab:: Store Data with the SDK
+      :tabid: device-persistence
 
-      Use the React Native SDK to build cross-platform applications in JavaScript or TypeScript.
+      .. procedure::
 
-   .. card::
-      :headline: Java SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/java/
-      :icon: /images/icons/android_sdk.svg
-      :icon-alt: Java SDK icon
+         .. step:: Install the SDK
 
-      Build Android applications in Java or Kotlin.
+            Use popular package managers and build tools to
+            :ref:`sdks-install` in your project.
 
-   .. card::
-      :headline: Web SDK
-      :url: https://www.mongodb.com/docs/realm/web/
-      :icon: /images/icons/web_sdk.svg
-      :icon-alt: Web SDK icon
+            Import the relevant dependency in your project files to get started.
 
-      Build web applications in JavaScript or TypeScript. Access data with MongoDB queries.
+         .. step:: Define an Object Schema
 
-   .. card::
-      :headline: Flutter SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/flutter
-      :icon: /images/icons/flutter.svg
-      :icon-alt: Flutter SDK icon
+            Use your preferred programming language to idiomatically 
+            :ref:`define an object model <sdks-object-models>`.
 
-      Build Flutter applications with Dart.
+         .. step:: Open a Database
 
-   .. card::
-      :headline: C++ SDK
-      :url: https://www.mongodb.com/docs/realm/sdk/cpp
-      :icon: /images/icons/cpp_sdk.svg
-      :icon-alt: C++ SDK icon
+            The SDK's database - Realm - stores objects in files on your 
+            device. Or you can open an in-memory database which does not 
+            create a file. 
+            :ref:`Configure and open a database <sdks-configure-and-open-database>`
+            to specify the options for your database file.
+
+         .. step:: Read and Write Data
+
+            :ref:`Create <sdks-crud-create>`, :ref:`read <sdks-crud-read>`,
+            :ref:`update <sdks-crud-update>`, and :ref:`delete <sdks-crud-delete>`
+            objects from the device database. Filter data using the 
+            :ref:`query engines <sdks-query-engines>` provided by the SDK.
+
+         .. step:: React to Changes
+
+            Live objects mean that your data is always up-to-date.
+            You can :ref:`register a notification handler <sdks-react-to-changes>`
+            to watch for changes and perform some logic, such as updating
+            your UI. Or use our React Native or SwiftUI support to
+            idiomatically to update Views when data changes.
+
+      .. image:: /images/illustrations/Spot_MauvePurple_Infrastructure_Tech_RealmApp2x.png
+         :alt: Atlas Device SDK Mobile Illustration
+
+   .. tab:: Sync Data Across Devices
+      :tabid: device-sync
+
+      .. procedure::
+
+         .. step:: Connect to an Atlas App Services App
+
+            Configure :ref:`Device Sync in an App Services App
+            <realm-sync-get-started>`. Define data access rules. Use
+            Development Mode to infer your schema from your client data model.
+
+            Then, :ref:`connect to Atlas <sdks-connect-to-atlas>` from
+            your client.
+
+         .. step:: Authenticate a User
+
+            Use one of our authentication providers to :ref:`authenticate a
+            user <sdks-authenticate-users>`. App Services provides access
+            to popular authentication providers, such as Apple, Google, or
+            Facebook. Use our built-in email/password provider to manage
+            users without a third-party, or use custom JWT authentication to
+            integrate with other authentication providers. Anonymous authentication
+            provides access without requiring a login or persisting user data.
+
+         .. step:: Open a Synced Database
+
+            :ref:`Configure and open a synced database <sdks-configure-and-open-synced-database>`.
+            :ref:`Subscribe to a query <sdks-manage-sync-subscriptions>`
+            to determine what data the synced database can read and write.
+
+         .. step:: Read and Write Synced Data
+
+            The APIs to read and write data are the same whether you're 
+            using a synced or non-synced database. Data that you read and write 
+            to the device is automatically kept in sync with your Atlas 
+            cluster and other clients. Apps keep working offline and 
+            deterministically sync changes whenever a network connection 
+            is available.
+
+      .. image:: /images/illustrations/Spot_AzureBlue_Mobile_Tech_RealmSync.png
+         :alt: Device Sync Illustration
+
+   .. tab:: Build with Atlas App Services
+      :tabid: app-services
+
+      .. container::
+
+         Call Serverless Functions
+         ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+         You can :ref:`call serverless Functions <ios-call-a-function>`
+         from your client application that run in an App Services backend.
+
+         Query MongoDB Atlas
+         ~~~~~~~~~~~~~~~~~~~
+
+         You can :ref:`query data stored in MongoDB <ios-mongodb-remote-access>`
+         directly from your client application code.
+
+         Authenticate Users
+         ~~~~~~~~~~~~~~~~~~
+
+         Authenticate users with built-in and third-party :ref:`authentication
+         providers <ios-authenticate-users>`. Use the authenticated user to
+         access App Services.
+
+      .. image:: /images/illustrations/Spot_MauvePurple_APIs_Tech_RealmApp.png
+         :alt: App Services Illustration
+
+
+   .. tab:: Develop with Popular Frameworks
+      :tabid: realm-frameworks
+
+      .. container::
+
+         Our SDKs offer framework-idiomatic tools to streamline your 
+         Atlas Device SDK development. In React Native, use our ``@realm/react``
+         hooks to manage the Atlas connection, authenticate users, and write to
+         the database. In Swift, use property wrappers and convenience 
+         features designed to make it easier to work with SwiftUI.
 
-      Build applications in C++. Access data stored in realms and sync data with Atlas.
+         .. literalinclude:: /examples/generated/swiftui/FilterData.snippet.searchable.swift
+            :language: swift
+            :caption: SwiftUI Property Wrappers Offer Realm/SwiftUI Integration
+            :copyable: false
 
-For legacy (pre-v10) Realm Documentation, see https://www.mongodb.com/docs/realm-legacy/docs/.
+      .. image:: /images/illustrations/Spot_MauvePurple_Logic_Tech_RealmApp2x.png
+         :alt: Atlas Device SDK Mobile Illustration
diff --git a/source/sdk/crud/create.txt b/source/sdk/crud/create.txt
@@ -9,3 +9,5 @@ Create Objects
    :backlinks: none
    :depth: 2
    :class: singlecol
+
+Placeholder page for Create an object content.
diff --git a/source/sdk/crud/delete.txt b/source/sdk/crud/delete.txt
@@ -9,3 +9,5 @@ Delete Objects
    :backlinks: none
    :depth: 2
    :class: singlecol
+
+Placeholder page for content related to deleting objects.
diff --git a/source/sdk/crud/read.txt b/source/sdk/crud/read.txt
@@ -17,3 +17,5 @@ Read Objects
    :backlinks: none
    :depth: 2
    :class: singlecol
+
+Placeholder page for content related to reading realm objects.
diff --git a/source/sdk/crud/update.txt b/source/sdk/crud/update.txt
@@ -9,3 +9,5 @@ Update Objects
    :backlinks: none
    :depth: 2
    :class: singlecol
+
+Placeholder page for content related to updating realm objects.
diff --git a/source/sdk/install.txt b/source/sdk/install.txt
@@ -0,0 +1,20 @@
+.. _sdks-install:
+
+========================
+Install Atlas Device SDK
+========================
+
+.. meta:: 
+   :description: Install Atlas Device SDK for your preferred language or framework using popular package managers and build tools. 
+
+.. facet::
+  :name: genre
+  :values: tutorial
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Placeholder page for Install content.
diff --git a/source/sdk/quick-start.txt b/source/sdk/quick-start.txt
@@ -0,0 +1,13 @@
+.. _sdks-quick-start:
+
+===========
+Quick Start
+===========
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Placeholder page for quick start content.
