Add Flex Clusters alongside Shared (#162) (#163)

* add Flex
* update admonition

Author: MongoCaleb

snooty.toml

@@ -76,10 +76,14 @@ encrypt-at-rest = "Encryption at Rest using Customer Key Management"
 ecosystem = "`MongoDB Partner Ecosystem Catalog <https://www.mongodb.com/ecosystem/>`__"
 FDI = "Federated Database Instance"
 fdi = "federated database instance"
+Flex-Cluster = "Flex Cluster"
+Flex-cluster = "Flex cluster"
+Flex-Clusters = "Flex Clusters"
+Flex-clusters = "Flex clusters"
 Free-cluster = "Free cluster"
-free-cluster = "free cluster"
+# free-cluster = "free cluster"
 Free-clusters = "Free clusters"
-free-clusters = "free clusters"
+# free-clusters = "free clusters"
 Free-Cluster = "Free Cluster"
 Free-Clusters = "Free Clusters"
 fts = "Atlas Search"
@@ -110,15 +114,15 @@ sdk = ":abbr:`SDK (Software Development Kit)`"
 service = "Atlas"
 service-api-v1-base-uri = "https://cloud.mongodb.com/api/atlas/v1.0"
 Serverless-instance = "Serverless instance"
-serverless-instance = "serverless instance"
+# serverless-instance = "serverless instance"
 Serverless-Instance = "Serverless Instance"
 Serverless-instances = "Serverless instances"
-serverless-instances = "serverless instances"
+# serverless-instances = "serverless instances"
 Serverless-Instances = "Serverless Instances"
 Shared-cluster = "Shared cluster"
-shared-cluster = "shared cluster"
+# shared-cluster = "shared cluster"
 Shared-clusters = "Shared clusters"
-shared-clusters = "shared clusters"
+# shared-clusters = "shared clusters"
 Shared-Cluster = "Shared Cluster"
 Shared-Clusters = "Shared Clusters"
 spi = "stream processing instance"

source/ak8so-back-up-deployment.txt

@@ -16,12 +16,12 @@ Back Up Your |service| {+Cluster+}
 
 .. note:: {+Serverless-instances+} back up automatically
 
-   |service| automatically enables backups for {+serverless-instances+}
+   |service| automatically enables backups for {+Serverless-instances+}
    and takes snapshots every six hours. Any |ak8so| backup custom
-   resources you apply to a {+serverless-instance+} will not override
+   resources you apply to a {+Serverless-instance+} will not override
    the automatic settings.
 
-   To learn more about backups for {+serverless-instances+}, see
+   To learn more about backups for {+Serverless-instances+}, see
    :ref:`serverless-snapshots`.
 
 |ak8so| supports :ref:`{+cloud-backup+} <backup-cloud-provider>` for

source/ak8so-bcp.txt

@@ -82,8 +82,8 @@ Prerequisites
   .. note::
 
      You can't convert a {+dedicated-cluster+} to an ``M0`` 
-     {+free-cluster+}, an ``M2`` or ``M5`` {+shared-cluster+}, or a 
-     {+serverless-instance+}.
+     {+Free-cluster+}, an ``M2`` or ``M5`` {+Shared-cluster+}, a 
+     {+Flex-cluster+}, or a {+Serverless-instance+}.
 
 Procedure
 ---------

source/ak8so-changelog.txt

@@ -702,7 +702,7 @@ New Features
 
 :ref:`atlasdeployment-custom-resource`:
 
-- Supports :ref:`{+serverless-instances+} <ak8so-serverless-instance>` 
+- Supports :ref:`{+Serverless-instances+} <ak8so-serverless-instance>` 
   via the :setting:`spec.serverlessSpec` field.
 - Supports :ref:`scheduled backups <ak8so-backup>` for 
   {+database-deployments+}.
@@ -717,7 +717,7 @@ New Features
   ``M0``, ``M2``, and ``M5`` {+clusters+}.
 - Supports omitting the 
   :setting:`spec.serverlessSpec.providerSettings.providerName` field for
-  {+serverless-instances+}.
+  {+Serverless-instances+}.
 
 Fixes
 ~~~~~

source/ak8so-private-link-serverless.txt

@@ -13,7 +13,7 @@ Manage Private Endpoints for {+Serverless-Instances+}
    :class: singlecol
 
 |ak8so| supports managing private endpoints for 
-{+serverless-instances+} on the following platforms: 
+{+Serverless-instances+} on the following platforms: 
 
 - |aws| using the `{+aws-pl+} <https://aws.amazon.com/privatelink/>`__
   feature.
@@ -35,7 +35,7 @@ Before you begin, see :ref:`ak8so-private-endpoint`.
 Procedure
 ---------
 
-To enable clients to connect to |service| {+serverless-instances+} 
+To enable clients to connect to |service| {+Serverless-instances+} 
 using private endpoints:
 
 .. tabs::

source/ak8so-private-link.txt

@@ -15,11 +15,11 @@ Manage Private Endpoints
 .. include:: /includes/fact-atlas-free-tier-limits.rst
 
 |ak8so| supports private endpoints to connect to 
-{+dedicated-clusters+}, {+serverless-instances+}, and {+fdi+}s.
+{+dedicated-clusters+}, {+Serverless-instances+}, and {+fdi+}s.
 
 When you use |ak8so| to configure private links in |service|, |service| 
 creates its own |vpc| or a Private Link service and places 
-{+dedicated-clusters+} or {+serverless-instances+} within a region 
+{+dedicated-clusters+} or {+Serverless-instances+} within a region 
 behind a load balancer in the |service| |vpc| or |service| VNet. To 
 learn more, see the :ref:`Private Endpoint Overview 
 <private-endpoint-overview>`.
@@ -31,7 +31,7 @@ update one of the following parameters:
   :setting:`spec.privateEndpoints` parameter for the 
   :ref:`atlasproject-custom-resource`.
 
-- For {+serverless-instances+}, specify the 
+- For {+Serverless-instances+}, specify the 
   :setting:`spec.serverlessSpec.privateEndpoints` parameter for the 
   :ref:`atlasdeployment-custom-resource`.
 
@@ -144,7 +144,7 @@ Procedure
 ---------
 
 To enable clients to connect to |service| {+dedicated-clusters+} or 
-{+serverless-instances+} using private endpoints, see the following 
+{+Serverless-instances+} using private endpoints, see the following 
 procedures:
 
 - :ref:`ak8so-private-endpoint-dedicated`

source/atlasdeployment-custom-resource.txt

@@ -13,9 +13,9 @@
    :class: singlecol
 
 The ``AtlasDeployment`` custom resource configures your MongoDB {+cluster+}
-or {+serverless-instance+} in |service|. When you create the ``AtlasDeployment``
+or {+Serverless-instance+} in |service|. When you create the ``AtlasDeployment``
 custom resource, |ak8so| tries to create or update a {+cluster+} or
-{+serverless-instance+} in |service|.
+{+Serverless-instance+} in |service|.
 
 .. important:: Action Required for Breaking Changes with |ak8so| 2.0
 
@@ -48,9 +48,9 @@ specify in the ``AtlasDeployment`` custom resource:
   to create a new {+cluster+} or update an existing {+cluster+}.
 - If you specify values for fields under ``spec.serverlessSpec``, |ak8so|
   uses the |service| :oas-atlas-tag:`Serverless Instance API Resource </Serverless-Instances>`
-  to create a new {+serverless-instance+} or update an existing {+serverless-instance+}.
+  to create a new {+Serverless-instance+} or update an existing {+Serverless-instance+}.
 
-Creating or updating a {+cluster+} or {+serverless-instance+} can take
+Creating or updating a {+cluster+} or {+Serverless-instance+} can take
 up to 10 minutes. |ak8so| monitors the update process.
 
 You can run the following command to check on the status:
@@ -73,7 +73,7 @@ provisioning:
        message: Cluster is provisioning
 
 The ``ClusterReady`` status will change to ``True`` when the {+cluster+}
-or {+serverless-instance+} is ready.
+or {+Serverless-instance+} is ready.
 
 .. _atlasdeployment-examples:
 
@@ -216,7 +216,7 @@ specification configured with some of the :oas-atlas-tag:`additional options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following example shows an ``AtlasDeployment`` custom resource
-specification configured for a {+serverless-instance+}:
+specification configured for a {+Serverless-instance+}:
 
 .. code-block::
 
@@ -421,7 +421,7 @@ parameters available.
 - For a full list of available parameters for {+clusters+},
   see the |service| :oas-atlas-op:`{+Clusters+} API </createCluster>`.
 
-- For a full list of available parameters for {+serverless-instances+},
+- For a full list of available parameters for {+Serverless-instances+},
   see the |service| :oas-atlas-tag:`{+Serverless-Instances+} API </Serverless-Instances>`.
 
 To customize your specifications, refer to these descriptions, the available
@@ -951,11 +951,11 @@ examples, and the |api| documentation.
 
    .. note::
 
-      You can change this setting to upgrade an ``M0``, ``M2``, or 
-      ``M5`` {+cluster+} to an ``M10+`` {+cluster+}. However, you can't 
-      upgrade an ``M0``, ``M2``, or ``M5`` {+cluster+} to another free 
+      You can change this setting to upgrade an ``M0``, ``M2``, ``M5``, or 
+      {+Flex-cluster+} to an ``M10+`` {+cluster+}. However, you can't 
+      upgrade an ``M0``, ``M2``, ``M5`, or {+Flex-cluster+} to another free 
       or shared {+cluster+}. For example, you can't upgrade an ``M0``
-      {+cluster+} to an ``M5`` {+cluster+}.
+      {+cluster+} to a {+Flex-cluster+}.
 
 .. setting:: spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount
 
@@ -1547,7 +1547,7 @@ examples, and the |api| documentation.
 
    *Conditional*
 
-   List that contains the {+serverless-instance+} parameters from the 
+   List that contains the {+Serverless-instance+} parameters from the 
    |api|. For a full list of available parameters, see the |service|
    :oas-atlas-tag:`{+Serverless-Instances+} API 
    </Serverless-Instances>`.
@@ -1566,7 +1566,7 @@ examples, and the |api| documentation.
 
    List that contains the :ref:`private endpoint 
    <ak8so-private-endpoint>` configurations for the 
-   {+serverless-instance+}.
+   {+Serverless-instance+}.
 
 .. setting:: spec.serverlessSpec.providerSettings
 
@@ -1578,9 +1578,9 @@ examples, and the |api| documentation.
    on which MongoDB runs. The available options are specific to the 
    cloud service provider. To learn more, see the :ref:`AWS 
    <amazon-aws>`, :ref:`GCP <google-gcp>`, and :ref:`Azure 
-   <microsoft-azure>` {+serverless-instance+} configuration options.
+   <microsoft-azure>` {+Serverless-instance+} configuration options.
 
-   If you want to create or update a {+serverless-instance+}, you must
+   If you want to create or update a {+Serverless-instance+}, you must
    specify this setting.
 
    .. important::
@@ -1604,7 +1604,7 @@ examples, and the |api| documentation.
    *Conditional*
 
    Cloud service provider on which |service| provisions the host for a 
-   {+serverless-instance+}.
+   {+Serverless-instance+}.
 
    |service| accepts the following values:
 
@@ -1625,7 +1625,7 @@ examples, and the |api| documentation.
 
    **Conditional**
 
-   Physical location of your MongoDB {+serverless-instance+}. The
+   Physical location of your MongoDB {+Serverless-instance+}. The
    region you choose can affect network latency for clients accessing
    your databases.
 

source/includes/fact-atlas-free-tier-limits.rst

@@ -1,5 +1,7 @@
 .. note::
 
-   This feature is not available for ``M0`` {+free-clusters+}, ``M2``, and
-   ``M5`` clusters. To learn more about which features are unavailable,
-   see :ref:`atlas-free-tier`.
+   This feature is not available for any of the following deployments:
+
+   - ``M0`` clusters
+   - ``M2/M5`` clusters
+   - {+Flex-clusters+}

source/includes/fact-custom-database-role-overview.rst

@@ -12,9 +12,9 @@ roles together with:
 
 You can assign multiple custom roles to each database user.
 
-.. note:: {+Free-Cluster+}, {+Shared-Cluster+}, and {+Serverless-Instance+} Limitation
+.. note:: Limitations
 
    Changes to :atlas:`custom roles </security-add-mongodb-roles>`
-   might take up to 30 seconds to deploy in ``M0`` {+free-clusters+},
-   ``M2/M5`` {+shared-clusters+}, and {+serverless-instances+}.
+   might take up to 30 seconds to deploy in ``M0`` {+Free-clusters+},
+   ``M2/M5`` {+Shared-clusters+}, {+Flex-clusters+}, and {+Serverless-instances+}.
 

source/includes/fact-serverless-adding-features.rst

@@ -1,4 +1,4 @@
 MongoDB plans to add support for more configurations and
-capabilities on {+serverless-instances+} over time. To learn which
-features MongoDB plans to support for {+serverless-instances+} in
+capabilities on {+Serverless-instances+} over time. To learn which
+features MongoDB plans to support for {+Serverless-instances+} in
 the future, see :ref:`<serverless-instance-limitations>`.