DOCSP-36039: surface link to Realm Kotlin SDK (#149)

* DOCSP-36039: surface link to Realm Kotlin SDK

* fix headings + other fic

* small fixes

* small fixes

* NR PR fixes 1

(cherry picked from commit cf7b97b)

Author: rustagir

source/faq.txt

@@ -4,20 +4,34 @@
 FAQ
 ===
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: troubleshooting, question, support
+
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
 
-What if I can't connect to a MongoDB instance?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+On this page, you can find frequently asked questions and their corresponding answers.
+
+.. tip::
+
+   If you can't find an answer to your question on this page, see the
+   :ref:`kotlin-issues-and-help` page for information on how to report issues.
+
+Why Am I Having Problems Connecting to a MongoDB Instance?
+----------------------------------------------------------
 
 If you have trouble connecting to a MongoDB deployment, see
 the :ref:`Connection Troubleshooting Guide <kotlin-connection-troubleshooting>`
 for possible solutions.
 
-How Is the Kotlin Driver Different from Kmongo?
+How is the Kotlin Driver Different from KMongo?
 -----------------------------------------------
 
 The Kotlin driver is the official MongoDB driver for Kotlin. It is
@@ -51,6 +65,22 @@ key differences:
 
 For more detailed information, see :ref:`Migrate from KMongo <kotlin-migrate-kmongo>`.
 
+What is the Difference Between the Kotlin Driver and the Kotlin SDK?
+--------------------------------------------------------------------
+
+MongoDB supports both mobile and server-side development in Kotlin. If
+you are developing a mobile application for Android or Kotlin
+Multiplatform (KMP), you can use the :realm:`MongoDB
+Atlas Device Kotlin SDK </sdk/kotlin/>` to access Atlas App Services and
+to manage your Realm data.
+
+The {+driver-short+} supports server-side development by providing a
+complete library for building idiomatic Kotlin applications. You can
+learn how to develop asynchronous applications in this documentation for
+the Kotlin Coroutine Driver, or you can view the :driver:`Kotlin Sync
+Driver documentation </kotlin-sync/>` to learn more about synchronous
+programming.
+
 .. _kotlin-faq-connection-pool:
 
 How Does Connection Pooling Work in the Kotlin Driver?
@@ -129,11 +159,5 @@ When ``MongoClient.close()`` is called by any thread, the driver
 closes all idle sockets and closes all sockets that are in
 use as they are returned to the pool.
 
-To learn more about connecting to MongoDB, refer to the :ref:`Connection Guide <connect-to-mongodb>`.
-
-Support
--------
-
-If you are unable to find the answer to your question here, try our forums and
-support channels listed in the :doc:`Issues and Help <issues-and-help>`
-section.
+To learn more about connecting to MongoDB, see the :ref:`Connection
+Guide <connect-to-mongodb>`.

source/index.txt

@@ -23,14 +23,20 @@ Introduction
 ------------
 
 Welcome to the documentation site for the Kotlin Driver, the official
-MongoDB driver for server-side Kotlin applications using coroutines. Download it using
-`Maven <https://maven.apache.org/>`__ or
-`Gradle <https://gradle.org/>`__, or set up a runnable project by
-following our Quick Start guide.
-
-If your Kotlin application requires synchronous processing, use the
-:driver:`Sync Driver </kotlin-sync/>` which uses synchronous operations
-to make blocking calls to MongoDB.
+MongoDB driver for server-side Kotlin applications that use coroutines.
+Download the driver by using `Maven <https://maven.apache.org/>`__ or `Gradle
+<https://gradle.org/>`__, or set up a runnable project by following our
+Quick Start guide.
+
+.. tip:: Other Kotlin Platforms for MongoDB
+
+   If your Kotlin application requires synchronous processing, use the
+   :driver:`Sync Driver </kotlin-sync/>`, which uses synchronous operations
+   to make blocking calls to MongoDB.
+   
+   If you are developing an Android or Kotlin Multiplatform (KMP)
+   application, you can use the :realm:`MongoDB Atlas Device Kotlin SDK </sdk/kotlin/>` 
+   to access Atlas App Services and to manage your Realm data.
 
 Quick Start
 -----------