(DOCSP-47208) Flag deprecation of various subresources (#222)

Author: lmkerbey-mdb

source/ak8so-network-peering.txt

@@ -278,4 +278,4 @@ Enable clients to connect to |service| clusters using a network peering connecti
                   :language: json
                   :visible: true
 
-                  READY
+                  READY

source/atlascustomrole-custom-resource.txt

@@ -13,6 +13,8 @@
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/subresource-deprecation.rst
+
 The ``AtlasCustomRole`` custom resource defines a :ref:`custom
 database role <mongodb-roles>` to allocate privileges to your
 :ref:`database users <mongodb-users>`.

source/atlasipaccesslist-custom-resource.txt

@@ -12,6 +12,8 @@
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/subresource-deprecation.rst
+
 The ``AtlasIPAccessList`` custom resource configures an :ref:`IP
 access list <access-list>` for an |service| project. An IP access list
 allows you to secure your project using a minimum-access policy.

source/atlasnetworkcontainer-custom-resource.txt

@@ -12,6 +12,8 @@
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/subresource-deprecation.rst
+
 The ``AtlasNetworkContainer`` custom resource defines a :ref:`network
 container <ak8so-network-peering>` for a |service|
 project. You create |vpc| peering connections between network

source/atlasnetworkpeering-custom-resource.txt

@@ -12,6 +12,8 @@
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/subresource-deprecation.rst
+
 The ``AtlasNetworkPeering`` custom resource defines a :ref:`network
 peering connection <ak8so-network-peering>` for a |service|
 project. Network peering connections isolate traffic from public

source/atlasprivateendpoint-custom-resource.txt

@@ -12,6 +12,8 @@
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/subresource-deprecation.rst
+
 The ``AtlasPrivateEndpoint`` custom resource configures a
 :ref:`private endpoint <private-endpoint-overview>` for a |service|
 project. This allows you to connect your cloud provider to |service|

source/atlasproject-custom-resource.txt

@@ -1237,17 +1237,16 @@ This section describes the ``AtlasProject`` custom resource parameters:
 
    *Optional*
 
-   Object that contains your custom role specifications.
+   *Deprecated*
 
    .. important::
-    
-      This parameter is deprecated beginning in version 2.6. To create
-      custom roles with |ak8so|, use the
-      :ref:`atlascustomrole-custom-resource`.
 
-      To learn more about the configuration parameters available from
-      the |api|, see the |service| :oas-atlas-op:`Custom Database
-      Roles API </createCustomDatabaseRole>`.
+      This parameter is deprecated as of |ak8so| ``2.6``. Migrate to the
+      :ref:`AtlasPrivateEndpoint Custom Resource
+      <atlascustomrole-custom-resource>` in accordance with the
+      :ref:`migration guide <ak8so-migrate-ptr>`.
+
+   Object that contains your custom role specifications.
 
 .. setting:: spec.encryptionAtRest
 
@@ -1869,6 +1868,16 @@ This section describes the ``AtlasProject`` custom resource parameters:
 
    *Optional*
 
+   *Deprecated*
+
+   .. important::
+
+      This parameter is deprecated as of |ak8so| ``2.8``. Migrate to the
+      :ref:`AtlasNetworkPeering <atlasnetworkpeering-custom-resource>` and
+      :ref:`AtlasNetworkContainer
+      <atlasnetworkcontainer-custom-resource>` custom resources in
+      accordance with the :ref:`migration guide <ak8so-migrate-ptr>`.
+
    List that contains the :ref:`network peering 
    <ak8so-network-peering>` configurations for the project.
 
@@ -1899,11 +1908,21 @@ This section describes the ``AtlasProject`` custom resource parameters:
 
    *Required*
 
+   *Deprecated*
+
+   .. important::
+
+      This parameter is deprecated as of |ak8so| ``2.7``. Migrate to the
+      :ref:`AtlasIPAccessList Custom Resource
+      <atlasipaccesslist-custom-resource>` in accordance with the
+      :ref:`migration guide <ak8so-migrate-ptr>`.
+
    IP access list that grants network access to |service| clusters in 
    the project. You can specify the following body parameters:
 
    .. include:: /includes/api/list-tables/requests/access-list.rst
 
+
 .. setting:: spec.settings
 
    *Type*: object
@@ -1974,6 +1993,15 @@ This section describes the ``AtlasProject`` custom resource parameters:
 
    *Optional*
 
+   *Deprecated*
+
+   .. important::
+
+      This parameter is deprecated as of |ak8so| ``2.6``. Migrate to the
+      :ref:`AtlasPrivateEndpoint Custom Resource
+      <atlasprivateendpoint-custom-resource>` in accordance with the
+      :ref:`migration guide <ak8so-migrate-ptr>`.
+
    List that contains the :ref:`private endpoint 
    <ak8so-private-endpoint>` configurations for the project.
 

source/includes/subresource-deprecation.rst

@@ -0,0 +1,6 @@
+.. important::
+
+   Legacy subresources are deprecated as of the release of their
+   corresponding CRDs. If your configuration currently relies on the
+   subresource form of this resource definition, :ref:`migrate to a
+   CRD <ak8so-migrate-ptr>`.