DOCSP-43584 -- Create Multi Cluster Sharded Cluster Overview Page (#1842)

* DOCSP-43584 -- Add page to toc

* DOCSP-43584 -- Add public preview banner to page

* DOCSP-43584 -- Fix title

* DOCSP-43584 -- Fix title

* DOCSP-43584 -- add banner

* DOCSP-43584 -- draft page copy

* DOCSP-43584 -- edit

* DOCSP-43584 -- edit

* DOCSP-43584 -- fix toc

* DOCSP-43584 -- fix toc

* DOCSP-43584 -- fix toc

* DOCSP-43584 -- external review revisions

* DOCSP-43584 -- external review revisions

* DOCSP-43584 -- copy review revisions

* DOCSP-43584 -- add link to ref docs

* DOCSP-43584 -- add multi-region latency warning

Author: jvincent-mongodb

snooty.toml

@@ -236,3 +236,13 @@ vault-short = "Vault"
 vpc = ":abbr:`VPC (Virtual Private Cloud)`"
 yaml = ":abbr:`YAML (Yet Another Markup Language)`"
 
+[[banners]]
+# dark mode/appearance in public preview
+targets = [
+    "k8s-operator-specification.txt",
+    "multi-cluster-sharded-cluster.txt"
+]
+variant = "warning"
+value = """
+        Multi-cluster Sharded Cluster Deployments are currently in public preview.
+        """

source/mdb-resources.txt

@@ -52,3 +52,4 @@ from the |k8s| |api|, without having to configure them in
    /tutorial/configure-mongodb-specific-storage
    /manage-users
    /connect
+ 

source/multi-cluster-sharded-cluster.txt

@@ -0,0 +1,50 @@
+.. _multi-cluster-sharded-cluster:
+
+==============================
+Multi-Cluster Sharded Cluster
+==============================
+
+.. default-domain:: mongodb
+
+.. meta::
+   :keywords: multicluster, multi-cluster
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+The multi-cluster sharded cluster deployment topology is currently in public preview. 
+Multi-cluster sharded cluster deployments are not recommended for 
+use in production environments, as there may be breaking changes in the 
+functionality before this features becomes generally available and supported 
+for production use. Moreover, during the public preview we are unable to provide 
+support for this specific deployment topology without prior commitment from the 
+product and engineering teams responsible for this feature.
+
+.. important:: 
+   
+   The multi-cluster sharded cluster functionality makes it possible to deploy
+   MongoDB resources across multiple |k8s| clusters in multiple geographic regions; 
+   however, doing so will likely increase latency for replication operations.
+
+If you are interested in discussing the public preview of multi-cluster 
+sharded cluster deployments, or have any feedback on the feature, please contact 
+your MongoDB account team.
+
+The scope of the public preview release of the multi-cluster sharded 
+cluster feature includes the following:
+
+- Implement multi-cluster sharded cluster deployment capabilities by defining 
+  a ``MongoDB`` custom resource as having a ``spec.topology`` value of 
+  ``MultiCluster``, and a ``spec.type`` value of ``ShardedCluster``.
+
+- Introduce the ability to override any settings for a particular shard 
+  via the new ``spec.shard.shardOverrides`` field.
+
+- Ensure backwards compatibility for existing :ref:`single-cluster MongoDB sharded 
+  cluster deployments <deploy-sharded-cluster>`.
+
+To learn more about the specific configuration options for the multi-cluster 
+sharded cluster topology, please see the :ref:`sharded cluster reference documentation <sharded-cluster-settings>`.

source/multi-cluster.txt

@@ -41,6 +41,9 @@ Deploy MongoDB Resources on Multiple Kubernetes Clusters
 :ref:`multi-cluster-no-service-mesh-deploy-rs`
   Deploy a |mongodb-multi| as a replica set without a service mesh.
 
+:ref:`multi-cluster-sharded-cluster`
+  Deploy a |mongodb-multi| as Sharded Clusters.
+
 :ref:`multi-cluster-edit-replica-set`
   Modify the configuration of a |mongodb-multi|.
 
@@ -73,7 +76,7 @@ Deploy MongoDB Resources on Multiple Kubernetes Clusters
    Edit a MongoDBMultiCluster Resource </tutorial/multi-cluster-edit-deployment>
    Secure Connections </tutorial/multi-cluster-secure-client-connections>
    Access Resources </multi-cluster-connect>
-
+   Sharded Cluster </multi-cluster-sharded-cluster>
    Disaster Recovery </multi-cluster-disaster-recovery>
    MongoDB Plugin Reference </plugin-reference>
    Troubleshoot Deployments </multi-cluster-troubleshooting>