(DOCSP-29260): Migrate from KMongo (#92)

# Pull Request Info

[PR Reviewing
Guidelines](https://github.com/mongodb/docs-java/blob/master/REVIEWING.md)

JIRA - https://jira.mongodb.org/browse/DOCSP-29260
Staging -
https://docs-mongodbcom-staging.corp.mongodb.com/kotlin/docsworker-xlarge/docsp-29260-migrate/migrate-kmongo/

## Self-Review Checklist

- [ ] Is this free of any warnings or errors in the RST?
- [ ] Did you run a spell-check?
- [ ] Did you run a grammar-check?
- [ ] Are all the links working?

Author: cbullinger

source/faq.txt

@@ -25,11 +25,7 @@ developed by the MongoDB team and provides a native API for Kotlin
 applications to connect to MongoDB and work with data. It is implemented
 by wrapping the :driver:`MongoDB Java driver </java-drivers/>`.
 
-`KMongo <https://litote.org/kmongo/>`__ is a popular community-developed library
-for working with MongoDB from Kotlin applications.
-It is also a wrapper around the Java driver.
-It was created prior to the creation of the official Kotlin driver to serve
-the needs of the Kotlin community.
+.. include:: /includes/kmongo-description.rst
 
 The Kotlin driver was developed in collaboration with the creator of KMongo,
 Julien Buret, to give users an officially-supported driver.
@@ -48,11 +44,13 @@ key differences:
 - The official driver does *not* have built-in support for `reactor <https://projectreactor.io/>`__,
   `rxjava2 <https://github.com/ReactiveX/RxJava>`__, `Jackson <https://github.com/FasterXML/jackson>`__,
   or `GSON <https://github.com/google/gson>`__.
-- The official driver does not support MongoDB shell commands.
+- The official driver does *not* support MongoDB shell commands.
 - The official driver supports type-safe queries with the Builders API,
   whereas KMongo uses infix functions and property references for
   type-safe queries.
 
+For more detailed information, see :ref:`Migrate from KMongo <kotlin-migrate-kmongo>`.
+
 .. _kotlin-faq-connection-pool:
 
 How Does Connection Pooling Work in the Kotlin Driver?

source/includes/kmongo-description.rst

@@ -0,0 +1,5 @@
+`KMongo <https://litote.org/kmongo/>`__ is a popular community-developed library
+for working with MongoDB from Kotlin applications.
+It is also a wrapper around the Java driver.
+It was created prior to the creation of the official Kotlin driver to serve
+the needs of the Kotlin community. As of July 2023, it has been marked as deprecated.

source/index.txt

@@ -16,6 +16,7 @@ MongoDB Kotlin Driver
    /connection-troubleshooting
    /issues-and-help
    /compatibility
+   /migrate-kmongo
    View the Source <https://github.com/mongodb/mongo-java-driver>
 
 Introduction