Merge pull request #7167 from ronaldbarendse/deploy/release-notes-20250612

Add Deploy 16 release notes and update version specific upgrade notes

Author: eshanrnh

16/umbraco-deploy/release-notes.md

@@ -2,7 +2,7 @@
 description: Get an overview of the things changed and fixed in each version of Umbraco Deploy.
 ---
 
-# Release notes
+# Release Notes
 
 In this section we have summarised the changes to Umbraco Deploy and [Deploy Contrib](https://github.com/umbraco/Umbraco.Deploy.Contrib) released in each version. Each version is presented with a link to the [Deploy issue tracker](https://github.com/umbraco/Umbraco.Deploy.Issues/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.
 
@@ -16,6 +16,25 @@ If you are upgrading to a new major version you can find the details about the b
 
 This section contains the release notes for Umbraco Deploy 15 including all changes for this version.
 
+### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 12th 2025)
+
+* Compatibility with Umbraco 16.0.0
+
+### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025)
+
+* Compatibility with Umbraco 16.0.0-rc6
+
+### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025)
+
+* Compatibility with Umbraco 16.0.0-rc5
+* Removed obsolete code
+
+### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 3rd 2025)
+
+* Compatibility with Umbraco 16.0.0-rc4
+* Add `deployEntityTypeMapping` manifest to allow mapping client-side entity types (used in workspaces and routes) to their server-side entity types (used in UDIs, artifacts, and service connectors)
+* Use default `TryParseUdiRangeFromNodeId` implementation for internally registered entity types
+
 ### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 30th 2025)
 
 * Compatibility with Umbraco 16.0.0-rc3
@@ -28,6 +47,22 @@ This section contains the release notes for Umbraco Deploy 15 including all chan
 
 ## Umbraco.Deploy.Contrib
 
+### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0) (May 12th 2025)
+
+* Compatibility with Umbraco 16.0.0 and Deploy 16.0.0
+
+### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc5) (May 10th 2025)
+
+* Compatibility with Umbraco 16.0.0-rc6 and Deploy 16.0.0-rc5
+
+### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc4) (May 10th 2025)
+
+* Compatibility with Umbraco 16.0.0-rc5 and Deploy 16.0.0-rc4
+
+### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc3) (May 3rd 2025)
+
+* Compatibility with Umbraco 16.0.0-rc4 and Deploy 16.0.0-rc3
+
 ### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc2) (May 30th 2025)
 
 * Compatibility with Umbraco 16.0.0-rc3 and Deploy 16.0.0-rc2

16/umbraco-deploy/upgrades/version-specific.md

@@ -21,14 +21,52 @@ Version 16 contains breaking changes. The breaking changes appear in areas relat
 
 #### Entity type registration
 
-Entity type registration is simplified by removing client-side concerns from the server and aligning built-in and custom Umbraco CMS entities (like Forms and Commerce).
+Entity type registration is simplified by removing client-side concerns from the server and aligning built-in Umbraco CMS and custom entities (like Forms and Commerce).
 
 * `IDiskEntityService.RegisterDiskEntityType(...)` - This now only requires the entity type, removing the `name`, `isUmbracoEntity` and `installedUdisGetter` parameters.
 * `ITransferEntityService.RegisterTransferEntityType(...)` - This is also simplified, removing the `name`, `isUmbracoEntity`, `treeAlias`, `matchesRoutePath`, `matchesNodeId` and `entitiesGetter` parameters.
 
-The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type.
-
-The `isUmbracoEntity` flag was used in the schema comparison dashboard and for setting signatures to fetch entities differently from custom ones. Making `installedUdisGetter` and `entitiesGetter` mandatory could fetch these items, but this is already possible via service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`).
+The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type if no translation is provided.
+
+The `isUmbracoEntity` flag was used when fetching entities in the schema comparison dashboard and for setting signatures. This could only be enabled for built-in Umbraco entities directly supported by Deploy. Custom entities required providing the `installedUdisGetter` or `entitiesGetter` parameter for these features to work correctly. However, getting all entities is already possible via the service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`), making these parameters redundant.
+
+The `treeAlias`, `matchesRoutePath`, and `matchesNodeId` parameters are removed because the client-side already tracks the entity types. It's recommended to use the same entity types on both the client (in workspaces and routes) and the server (in UDIs, artifacts, and service connectors). If different, Deploy supports mapping the client-side entity types to their server-side counterpart using a `deployEntityTypeMapping` manifest, as shown in the following example:
+
+```json
+{
+  "id": "Umbraco.Commerce.Deploy",
+  "name": "Umbraco Commerce Deploy",
+  "version": "16.0.0",
+  "extensions": [
+    {
+      "type": "localization",
+      "alias": "Uc.Deploy.Localization.En",
+      "weight": -100,
+      "name": "English",
+      "meta": {
+        "culture": "en",
+        "localizations": {
+          "deploy_entityTypes": {
+            "umbraco-commerce-product-attribute": "Umbraco Commerce Product Attribute",
+            "umbraco-commerce-product-attribute-preset": "Umbraco Commerce Product Attribute Preset",
+          }
+        }
+      }
+    },
+    {
+      "type": "deployEntityTypeMapping",
+      "alias": "Uc.Deploy.EntityTypeMapping",
+      "name": "Umbraco Commerce Deploy Entity Type Mapping",
+      "entityTypes": {
+        "uc:product-attribute": "umbraco-commerce-product-attribute",
+        "uc:product-attributes": "umbraco-commerce-product-attribute",
+        "uc:product-attribute-preset": "umbraco-commerce-product-attribute-preset",
+        "uc:product-attribute-presets": "umbraco-commerce-product-attribute-preset"
+      }
+    }
+  ]
+}
+```
 
 ### Dependencies
 

16/umbraco-forms/release-notes.md

@@ -50,6 +50,18 @@ This section contains the release notes for Umbraco Forms 16 including all chang
 
 This Deploy add-on adds support for transferring, restoring, exporting and importing (including migrating between major versions) of Umbraco Forms data.
 
+### 16.0.0 (June 12th 2025)
+
+* Update Forms and Deploy dependencies to 16.0.0
+
+### 16.0.0-rc5 (June 10th 2025)
+
+* Update Forms and Deploy dependencies to 16.0.0-rc5
+
+### 16.0.0-rc4 (June 10th 2025)
+
+* Update Forms and Deploy dependencies to 16.0.0-rc4
+
 ### 16.0.0-rc3 (June 3rd 2025)
 
 * Update Forms and Deploy dependencies to 16.0.0-rc3