(DOCSP-48026) First draft of migration guide changes. (#211)

* (DOCSP-48026) First draft of migration guide changes.

* (DOCSP-48026) Formatting fix.

* (DOCSP-48026) Copy review.

Author: lmkerbey-mdb

source/migrate-parameter-to-resource.txt

@@ -42,6 +42,65 @@ The following configurations are affected:
    * - :setting:`spec.privateEndpoints`
      - :ref:`atlasprivateendpoint-custom-resource`
 
+   * - :setting:`spec.projectIpAccessList`
+     - :ref:`atlasipaccesslist-custom-resource`
+
+   * - :setting:`spec.networkPeers`
+     - :ref:`atlasnetworkpeering-custom-resource`
+
+   * - ``spec.networkPeers.containerId``
+     - :ref:`atlasnetworkcontainer-custom-resource`
+
+.. _ak8so-migrate-ptr-considerations:
+
+Resource-Specific Considerations
+--------------------------------
+
+Before you migrate parameters to resources, consider any
+implementation details specific to those parameters.
+
+.. _ak8so-migrate-ptr-considerations-networkpeering:
+
+Network Peering
+~~~~~~~~~~~~~~~
+
+The following considerations apply to ``atlasNetworkPeering``
+resources:
+
+- An ``atlasNetworkPeering`` CRD can refer to its corresponding
+  ``atlasNetworkContainer`` by a |k8s| name reference or ID.
+
+- An ``atlasNetworkPeering`` CRD can refer to the ``atlasProject``
+  that hosts it by a |k8s| name reference or ID.
+
+- The :setting:`spec.networkPeers` parameter of an ``atlasProject``
+  CRD contains details of both the peering connection itself and the
+  container that supports it. When you migrate from this parameter to
+  an ``atlasNetworkPeering`` CRD, you might need to create an
+  ``atlasNetworkContainer`` CRD for the container that supports
+  it. To learn more, see :ref:`ak8so-migrate-ptr-considerations-networkcontainer`.
+
+.. _ak8so-migrate-ptr-considerations-networkcontainer:
+
+Network Container
+~~~~~~~~~~~~~~~~~
+
+The following considerations apply to ``atlasNetworkContainer``
+resources:
+
+- You don't need to create a new ``atlasNetworkContainer`` resource
+  when you migrate the ``atlasNetworkPeering`` connection from a
+  parameter to a resource if either:
+
+  - You manage the network container supporting an ``atlasNetworkPeering``
+    connection outside of the |ak8so| ``atlasProject`` in which you
+    manage the ``atlasNetworkPeering`` connection
+  - An ``atlasNetworkContainer`` resource for the
+    ``atlasNetworkPeering`` connection's container already exists.
+
+- An ``atlasNetworkContainer`` CRD can refer to its host
+  ``atlasProject`` by a |k8s| name reference or ID.
+
 .. _ak8so-migrate-ptr-procedure:
 
 Migration Procedure