From 6956e1a803b0a38d5a226e7356d5e8b715a6b1d9 Mon Sep 17 00:00:00 2001 From: Witek Socha Date: Tue, 8 Jul 2025 11:09:03 +0200 Subject: [PATCH 1/3] Add more explicit warning. --- CHANGELOG.md | 9 ++++++++- docs/updating/update-to-46.md | 13 ++++++++++++- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 82cca322900..99813ef829d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,13 @@ We are happy to announce the release of CKEditor 5 v46.0.0. ### Release highlights +> [!IMPORTANT] +> This is a **major release** with significant amount of changes that may affect your CKEditor 5 integration. We strongly encourage you to read the entire [update guide](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46) to understand all the changes. +> Pay special attention to: +> * [Unified exports and renames in the editor API](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46#unified-exports-and-renames-in-the-editor-api): Many import/export names have changed +> * [Introduction of the default content styles](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46#introduction-of-the-default-content-styles): New default styling that may affect your content appearance +> These changes are designed to improve the long-term stability and maintainability of CKEditor 5, but they require careful attention during the upgrade process. + #### Line Height (⭐) The new [Line Height](https://ckeditor.com/docs/ckeditor5/latest/features/line-height.html) feature allows you to adjust the vertical spacing between lines of text, improving readability and visual harmony in your documents. This premium feature lets you set consistent line spacing across paragraphs and text blocks to enhance document accessibility and maintain visual hierarchy in your content. @@ -42,7 +49,7 @@ The `AddCommandThreadCommand#isEnabled` property is no longer `false` when the c ##### Comments and suggestions annotations We have introduced dedicated methods for an easier way to get specific annotations related to a comment or a suggestion and vice versa. -#### Unified imports and renames in the editor API +#### Unified exports and renames in the editor API After the big New Installation Method release (v42.0.0+), some developers upgrading from v41-x to v42-x were greeted by the `does not provide an export named ...` error. We addressed issues immediately as they were reported, but we knew it required a deeper are more comprehensive approach long-term. diff --git a/docs/updating/update-to-46.md b/docs/updating/update-to-46.md index 3d7a1b08e85..b19413d266a 100644 --- a/docs/updating/update-to-46.md +++ b/docs/updating/update-to-46.md @@ -20,6 +20,17 @@ Released on 9 July, 2025. ([See full release notes](https://github.com/ckeditor/ CKEditor 5 v46.0.0 brings several major improvements and changes that enhance both the developer and end-user experience. This release includes significant API refinements, new features, and improvements to existing functionality. Below are the most important changes that require your attention when upgrading to CKEditor 5 v46.0.0. + + This is a **major release** with significant amount of changes that may affect your CKEditor 5 integration. We strongly encourage you to read the entire update guide to understand all the changes. + + Pay special attention to: + * [Unified exports and renames in the editor API](#unified-exports-and-renames-in-the-editor-api): Many import/export names have changed + * [Introduction of the default content styles](#introduction-of-the-default-content-styles): New default styling that may affect your content appearance + + These changes are designed to improve the long-term stability and maintainability of CKEditor 5, but they require careful attention during the upgrade process. + + + ### Line height feature (⭐) The new {@link features/line-height line height} feature allows you to adjust the vertical spacing between lines of text, improving readability and visual harmony in your documents. This premium feature lets you set consistent line spacing across paragraphs and text blocks to enhance document accessibility and maintain visual hierarchy in your content. @@ -50,7 +61,7 @@ We have added the `config.cloudServices.autoRefresh` configuration property to d This property opens up the ability to implement custom token handling if a certain use case requires this. -### Unified imports and renames in the editor API +### Unified exports and renames in the editor API This release is also about tidying up the rough edges that showed up after the big New Installation Method release (v42.0.0+). In cases where many helpers or methods from the framework’s APIs were used, some developers upgrading from v41.x to v42.x were greeted by the `does not provide an export named …` error. We addressed issues immediately as they were reported, but we knew it required a deeper are more comprehensive approach long-term. From 629dc5c5d2bee519524a3216166db8c83617f1a6 Mon Sep 17 00:00:00 2001 From: Bartek Biedrzycki Date: Tue, 8 Jul 2025 11:22:16 +0200 Subject: [PATCH 2/3] Docs: finafinal2 (update links). [short flow] --- CHANGELOG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 99813ef829d..9a8b06ca3fa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,8 +10,8 @@ We are happy to announce the release of CKEditor 5 v46.0.0. > [!IMPORTANT] > This is a **major release** with significant amount of changes that may affect your CKEditor 5 integration. We strongly encourage you to read the entire [update guide](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46) to understand all the changes. > Pay special attention to: -> * [Unified exports and renames in the editor API](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46#unified-exports-and-renames-in-the-editor-api): Many import/export names have changed -> * [Introduction of the default content styles](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46#introduction-of-the-default-content-styles): New default styling that may affect your content appearance +> * [Unified exports and renames in the editor API](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46.html#unified-exports-and-renames-in-the-editor-api): Many import/export names have changed +> * [Introduction of the default content styles](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46.html#introduction-of-the-default-content-styles): New default styling that may affect your content appearance > These changes are designed to improve the long-term stability and maintainability of CKEditor 5, but they require careful attention during the upgrade process. #### Line Height (⭐) From 3f06f625cfff55e4ff1936ec9a60e75327c90c82 Mon Sep 17 00:00:00 2001 From: Bartek Biedrzycki Date: Tue, 8 Jul 2025 11:23:04 +0200 Subject: [PATCH 3/3] Docs: finafinal3 (update link). [short flow] --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9a8b06ca3fa..b5e678c71ae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,7 @@ We are happy to announce the release of CKEditor 5 v46.0.0. ### Release highlights > [!IMPORTANT] -> This is a **major release** with significant amount of changes that may affect your CKEditor 5 integration. We strongly encourage you to read the entire [update guide](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46) to understand all the changes. +> This is a **major release** with significant amount of changes that may affect your CKEditor 5 integration. We strongly encourage you to read the entire [update guide](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46.html) to understand all the changes. > Pay special attention to: > * [Unified exports and renames in the editor API](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46.html#unified-exports-and-renames-in-the-editor-api): Many import/export names have changed > * [Introduction of the default content styles](https://ckeditor.com/docs/ckeditor5/latest/updating/guides/update-to-46.html#introduction-of-the-default-content-styles): New default styling that may affect your content appearance