DOCSP-34449 - Cosmos DB comparison page (#938)

Author: mongoKart

snooty.toml

@@ -9,6 +9,7 @@ toc_landing_pages = [
     "/use-cases",
     "/ruby-drivers",
     "/csharp-drivers",
+    "/other-document-dbs",
 ]
 
 intersphinx = ["https://www.mongodb.com/docs/manual/objects.inv"]

source/cosmosdb-support.txt

@@ -0,0 +1,79 @@
+.. _cosmosdb-compat:
+
+:noprevnext:
+
+=============================
+Azure Cosmos DB Compatibility
+=============================
+
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta:: 
+   :keywords: microsoft, support
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+
+.. figure:: /figures/cosmosdb.png
+   :alt: Azure Cosmos DB logo
+
+`Azure Cosmos DB for MongoDB <https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/introduction>`__
+makes it easy to use Azure Cosmos DB as if it were a MongoDB database.
+With Azure Cosmos DB, you can run the same application code and use the same drivers
+and tools that you use with MongoDB.
+
+Azure Cosmos DB for MongoDB implements MongoDB's
+`Wire Protocol <https://www.mongodb.com/docs/manual/reference/mongodb-wire-protocol/>`__
+to allow MongoDB `drivers <https://www.mongodb.com/docs/drivers/>`__ to connect and
+interact with Cosmos DB as though it were a MongoDB host. However, this
+implementation has limitations, as outlined in the :ref:`cosmosdb-compat-section` section
+of this page.
+
+Version Information
+-------------------
+
+Azure Cosmos DB supports MongoDB v4.2, or MongoDB v5.0 for vCore clusters.
+These versions don't support all the newer features and functionality in the versions of
+MongoDB available on `MongoDB Atlas. <https://www.mongodb.com/docs/atlas/>`__
+
+.. tip:: MongoDB Version History
+   
+   To learn more about the features available in each version of MongoDB, see 
+   `MongoDB Evolved - Version History. <https://www.mongodb.com/evolved>`__
+
+.. _cosmosdb-compat-section:
+
+Compatibility
+-------------
+
+As of October 2023, Azure Cosmos DB is about 32 percent compatible with the
+MongoDB API.
+
+On Azure Cosmos DB for MongoDB v4.2, the following MongoDB v4.2 features are
+available in a limited capacity or are not supported at all:
+
+- **Features**: `Text indexes <https://www.mongodb.com/docs/manual/core/indexes/index-types/index-text/>`__,
+  `2d indexes <https://www.mongodb.com/docs/manual/core/indexes/index-types/geospatial/2d/#std-label-2d-index>`__,
+  `hashed indexes <https://www.mongodb.com/docs/manual/core/indexes/index-types/index-hashed/#std-label-index-type-hashed>`__,
+  `case-insensitive indexes <https://www.mongodb.com/docs/manual/core/index-case-insensitive/>`__,
+  `sparse indexes <https://www.mongodb.com/docs/manual/core/index-sparse/>`__
+- **Aggregation Stages**: ``$collStats``, ``$bucket``, ``$bucketAuto``, ``$currentOp``,
+  ``$indexStats``, ``$listLocalSessions``, ``$listSessions``, ``$lookup``
+
+To learn more about Azure Cosmos DB's compatibility with MongoDB v4.2,
+see Microsoft's `Azure Cosmos DB for MongoDB (4.2 server version): Supported features and syntax <https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/feature-support-42>`__
+documentation.
+
+For the most current compatibility status between Azure Cosmos DB and MongoDB, see the
+`Is Cosmos DB Compatible with MongoDB Atlas? <https://www.iscosmosdbreallymongodb.com/>`__
+website.
+
+Support
+-------
+
+MongoDB doesn't offer commercial support for Azure Cosmos DB. For help with this product,
+contact `Azure Support. <https://azure.microsoft.com/en-us/support/>`__

source/documentdb-support.txt

@@ -1,5 +1,7 @@
 .. _documentdb-compat:
 
+:noprevnext:
+
 ===============================
 Amazon DocumentDB Compatibility
 ===============================
@@ -75,8 +77,9 @@ see the following AWS documentation:
 - `Functional Differences: Amazon DocumentDB and MongoDB <https://docs.aws.amazon.com/documentdb/latest/developerguide/functional-differences.html>`__
 - `Supported MongoDB APIs, Operations, and Data Types <https://docs.aws.amazon.com/documentdb/latest/developerguide/mongo-apis.html>`__
 
-For the most current compatibility status between Amazon DocumentDB and MongoDB, see
+For the most current compatibility status between Amazon DocumentDB and MongoDB, see the
 `Is Amazon DocumentDB Compatible with MongoDB Atlas? <https://www.isdocumentdbreallymongodb.com/>`__
+website.
 
 Support
 -------

source/figures/cosmosdb.png

@@ -150,6 +150,7 @@ See the following pages for information about other document databases' compatib
 with MongoDB:
 
 - :ref:`documentdb-compat`
+- :ref:`cosmosdb-compat`
 
 .. toctree::
 
@@ -168,3 +169,4 @@ with MongoDB:
    Swift Driver </swift>
    TypeScript </typescript>
    About Compatibility Tables <about-compatibility>
+   Other Document Database Compatibility <other-document-dbs>

source/index.txt

@@ -0,0 +1,17 @@
+=====================================
+Other Document Database Compatibility
+=====================================
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   /documentdb-support
+   /cosmosdb-support
+
+See the following pages for information about other document databases' compatibility
+with MongoDB:
+
+- :ref:`documentdb-compat`
+- :ref:`cosmosdb-compat`
+