diff --git a/releasenotes/notes/deprecated-network-data-v1-f1490ba769f6aa7a.yaml b/releasenotes/notes/deprecated-network-data-v1-f1490ba769f6aa7a.yaml
new file mode 100644
index 000000000..246832391
--- /dev/null
+++ b/releasenotes/notes/deprecated-network-data-v1-f1490ba769f6aa7a.yaml
@@ -0,0 +1,54 @@
+---
+features:
+  - |
+    Neutron resources for overcloud deployments on the undercloud is now
+    managed with tooling external to the Heat stack.
+
+    Networks and subnet resources as well as Virtual IPs for an overcloud
+    can either be manged using separate commands or the all-in-one
+    ``overcloud deploy`` by using the new network data YAML definition as
+    ``--networks-file`` and the ``--vip-file`` arguments with this command.
+
+    Overcloud node network ports are now managed by the baremetal node
+    provisioning workflow. Baremeteal nodes, and the network resources, can
+    be provisioned using the separate ``overcloud node provision`` command.
+    Alternatively the all-in-one ``overcloud deploy`` command will run the
+    baremetal node provisioning steps if the ``--baremetal-deployment``
+    argument is used.
+
+    Please refer to the `Networking Version 2 (Two)
+    <https://docs.openstack.org/project-deploy-guide/tripleo-docs/latest/deployment/network_v2.html>`_.
+    documentation page for more details.
+upgrade:
+  - |
+    The network data defintion used with the overcloud deployement must be
+    updated to version 2. The undercloud upgrade will execute the command
+    (``openstack overcloud network extract``) to generate the network data
+    definition for each deployed overcloud. The undercloud upgrade will save
+    the new file in the working directory for each stack, defaults to
+    ``overcloud-deploy/<STACK_NAME>/tripleo-<STACK_NAME>-network-data.yaml``.
+  - |
+    A new YAML definition file for overcloud stack virtual IPs must be used.
+    The undercloud upgrade will execute the command (``overcloud network vip
+    extract``) to generate this file for each deployed overcloud. The
+    undercloud upgrade will save the new file in the working directory for
+    each stack, defaults to
+    ``overcloud-deploy/< STACK_NAME>/tripleo-<STACK_NAME>-virtual-ips.yaml``.
+  - The baremetal node defintion has been extended to support neutron port
+    resource managment, this requires additional input in the YAML definition
+    used for baremetal node provisioning. The undercloud upgrade will execute
+    the command (``overcloud node extract provisioned``) to generate this file
+    for each deployed overcloud. The undercloud upgrade will save the new file
+    in the working directory for each stack, defaults to
+    ``overcloud-deploy/<STACK_NAME>/tripleo-<STACK_NAME>-baremetal-deployment.yaml.yaml``.
+deprecations:
+  - |
+    To enable management of neutron resources external to Heat the network data
+    YAML definition schema has been updated. The previous schema version has been
+    deprecated, using the deprecated v1 schema is only possible when the deprecated
+    non-ephemeral Heat on the Undercloud.
+  - |
+    Managing netron resources for composable networks is now enabled by default when
+    provisioning baremetal nodes. The option ``--network-ports`` has been deprecated,
+    and is a NOOP until it is fully removed.
+