Breaking changes and asynchronous package migrations.

Author: AndyButland

16/umbraco-cms/extending/packages/creating-a-package.md

@@ -124,7 +124,7 @@ You can specify package metadata directly in the `csproj` file. Here, is an exam
 ```xml
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
-        . . . 
+        . . .
         <Title>CustomWelcomeDashboard</Title>
         <Description>Custom welcome dashboard for Umbraco.</Description>
         <PackageTags>umbraco plugin package</PackageTags>
@@ -282,7 +282,7 @@ public class CustomPackageMigration : PackageMigrationBase
         IShortStringHelper shortStringHelper,
         IContentTypeBaseServiceProvider contentTypeBaseServiceProvider,
         IMigrationContext context,
-        IOptions<PackageMigrationSettings> packageMigrationsSettings) 
+        IOptions<PackageMigrationSettings> packageMigrationsSettings)
         : base(
             packagingService,
             mediaService,
@@ -302,6 +302,54 @@ public class CustomPackageMigration : PackageMigrationBase
 }
 ```
 
+If your migration step has a requirement for asynchronous work, you can also inherit from `AsyncPackageMigrationBase`:
+
+```csharp
+using Microsoft.Extensions.Options;
+using Umbraco.Cms.Core.Configuration.Models;
+using Umbraco.Cms.Core.IO;
+using Umbraco.Cms.Core.Models.Membership;
+using Umbraco.Cms.Core.PropertyEditors;
+using Umbraco.Cms.Core.Services;
+using Umbraco.Cms.Core.Strings;
+using Umbraco.Cms.Infrastructure.Migrations;
+using Umbraco.Cms.Infrastructure.Packaging;
+
+namespace Umbraco.Cms.Web.UI.Custom.PackageMigration;
+
+public class CustomPackageAsyncMigration : AsyncPackageMigrationBase
+{
+
+    public TestMigrationStep2(
+        IPackagingService packagingService,
+        IMediaService mediaService,
+        MediaFileManager mediaFileManager,
+        MediaUrlGeneratorCollection mediaUrlGenerators,
+        IShortStringHelper shortStringHelper,
+        IContentTypeBaseServiceProvider contentTypeBaseServiceProvider,
+        IMigrationContext context,
+        IOptions<PackageMigrationSettings> packageMigrationsSettings,
+        IUserGroupService userGroupService,
+        IUserService userService)
+        : base(
+              packagingService,
+              mediaService,
+              mediaFileManager,
+              mediaUrlGenerators,
+              shortStringHelper,
+              contentTypeBaseServiceProvider,
+              context,
+              packageMigrationsSettings)
+    {
+    }
+
+    protected override async Task MigrateAsync()
+    {
+        // Use await for asynchronous work.
+    }
+}
+```
+
 Here we also added the ZIP file as an embedded resource to the package project.
 
 ![ZIP as an embedded resource](<../../../../10/umbraco-cms/extending/packages/images/embeded-resource-props (1).png>)

16/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md

@@ -19,6 +19,22 @@ Use the [general upgrade guide](../) to complete the upgrade of your project.
 
 <details>
 
+<summary>Umbraco 16</summary>
+
+**TinyMCE is removed**
+
+In Umbraco 15 there were two property editors available for a rich text editor - TinyMCE and TipTap.
+
+With Umbraco 16 only TipTap is available as an option out-of-the-box.  TinyMCE's [change of license](https://github.com/tinymce/tinymce/issues/9453#issuecomment-2327646149) precludes us from shipping it with the MIT licensed Umbraco CMS.
+
+When upgrading to Umbraco 16 any data types using TinyMCE will be migrated to use TipTap.
+
+To continue to use TinyMCE a third-party package will need to be installed prior to the upgrade. That will disable the migration and allow you to continue with TinyMCE.
+
+</details>
+
+<details>
+
 <summary>Umbraco 15</summary>
 
 **Snapshots are removed**