From bf48e6ef0187d317ffbee4827f2c9916de521907 Mon Sep 17 00:00:00 2001
From: Karl Kemister-Sheppard <karlkemistersheppard@gmail.com>
Date: Thu, 29 Oct 2026 11:43:01 +1000
Subject: [PATCH 1/2] TINYDOC-3691: TinyMCE 8.10.2 Release Documentation.

---
 modules/ROOT/nav.adoc                        |  16 ++
 modules/ROOT/pages/8.10.2-release-notes.adoc | 195 +++++++++++++++++++
 modules/ROOT/pages/changelog.adoc            |   4 +
 modules/ROOT/pages/release-notes.adoc        |   8 +-
 4 files changed, 222 insertions(+), 1 deletion(-)
 create mode 100644 modules/ROOT/pages/8.10.2-release-notes.adoc

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 11180e2590..5fbea81874 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -431,6 +431,22 @@
 ** xref:tinymce-and-cors.adoc[Cross-Origin Resource Sharing (CORS)]
 * Release information
 ** xref:release-notes.adoc[Release notes for {productname}]
+*** {productname} 8.10.2
+**** xref:8.10.2-release-notes.adoc#overview[Overview]
+**** xref:8.10.2-release-notes.adoc#new-premium-plugin<s>[New Premium Plugin<s>]
+**** xref:8.10.2-release-notes.adoc#new-open-source-plugin<s>[New Open Source Plugin<s>]
+**** xref:8.10.2-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes]
+**** xref:8.10.2-release-notes.adoc#accompanying-premium-plugin-end-of-life-announcement[Accompanying Premium Plugin end-of-life announcement]
+**** xref:8.10.2-release-notes.adoc#accompanying-open-source-plugin-end-of-life-announcement[Accompanying Open Source Plugin end-of-life announcement]
+**** xref:8.10.2-release-notes.adoc#accompanying-enhanced-skins-and-icon-packs-changes[Accompanying Enhanced Skins & Icon Packs changes]
+**** xref:8.10.2-release-notes.adoc#improvements[Improvements]
+**** xref:8.10.2-release-notes.adoc#additions[Additions]
+**** xref:8.10.2-release-notes.adoc#changes[Changes]
+**** xref:8.10.2-release-notes.adoc#removed[Removed]
+**** xref:8.10.2-release-notes.adoc#bug-fixes[Bug fixes]
+**** xref:8.10.2-release-notes.adoc#security-fixes[Security fixes]
+**** xref:8.10.2-release-notes.adoc#deprecated[Deprecated]
+**** xref:8.10.2-release-notes.adoc#known-issues[Known issues]
 *** {productname} 8.10.1
 **** xref:8.10.1-release-notes.adoc#overview[Overview]
 **** xref:8.10.1-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes]
diff --git a/modules/ROOT/pages/8.10.2-release-notes.adoc b/modules/ROOT/pages/8.10.2-release-notes.adoc
new file mode 100644
index 0000000000..5a58bcbba0
--- /dev/null
+++ b/modules/ROOT/pages/8.10.2-release-notes.adoc
@@ -0,0 +1,195 @@
+= {productname} {release-version}
+:release-version: 8.10.2
+:navtitle: {productname} {release-version}
+:description: Release notes for {productname} {release-version}
+:keywords: releasenotes, new, changes, bugfixes
+:page-toclevels: 1
+
+include::partial$misc/admon-releasenotes-for-stable.adoc[]
+
+
+[[overview]]
+== Overview
+
+{productname} {release-version} was released for {enterpriseversion} and {cloudname} on <weekday>, <month> <DD>^<st|nd|rd|th>^, <YYYY>. These release notes provide an overview of the changes for {productname} {release-version}, including:
+
+// Remove sections and section boilerplates as necessary.
+// Pluralise as necessary or remove the placeholder plural marker.
+* xref:new-premium-plugin<s>[New Premium plugin<s>]
+* xref:new-open-source-plugin<s>[New Open Source plugin<s>]
+* xref:accompanying-premium-plugin-changes[Accompanying Premium plugin changes]
+* xref:accompanying-premium-plugin-end-of-life-announcement[Accompanying Premium plugin end-of-life announcement]
+* xref:accompanying-open-source-plugin-end-of-life-announcement[Accompanying open source plugin end-of-life-announcement]
+* xref:accompanying-enhanced-skins-and-icon-packs-changes[Accompanying Enhanced Skins & Icon Packs changes]
+* xref:improvements[Improvements]
+* xref:additions[Additions]
+* xref:changes[Changes]
+* xref:bug-fixes[Bug fixes]
+* xref:security-fixes[Security fixes]
+* xref:deprecated[Deprecated]
+* xref:known-issues[Known issues]
+
+
+[[new-premium-plugin<s>]]
+== New Premium plugin<s>
+
+The following new Premium plugin was released alongside {productname} {release-version}.
+
+=== <Premium plugin name>
+
+The new Premium plugin, **<Premium plugin name>** // description here.
+
+For information on the **<Premium plugin name>** plugin, see xref:<plugincode>.adoc[<Premium plugin name>].
+
+
+[[new-open-source-plugin]]
+== New Open Source plugin
+
+The following new Open Source plugin was released alongside {productname} {release-version}.
+
+=== <Open source plugin name>
+
+The new open source plugin, **<Open source plugin name>** // description here.
+
+For information on the **<Open source plugin name>** plugin, see xref:<plugincode>.adoc[<Open source plugin name>].
+
+
+[[accompanying-premium-plugin-changes]]
+== Accompanying Premium plugin changes
+
+The following premium plugin updates were released alongside {productname} {release-version}.
+
+=== <Premium plugin name 1> <Premium plugin name 1 version>
+
+The {productname} {release-version} release includes an accompanying release of the **<Premium plugin name 1>** premium plugin.
+
+**<Premium plugin name 1>** <Premium plugin name 1 version> includes the following <fixes, changes, improvements>.
+
+==== <Premium plugin name 1 change 1>
+
+// CCFR here.
+
+For information on the **<Premium plugin name 1>** plugin, see: xref:<plugincode>.adoc[<Premium plugin name 1>].
+
+
+[[accompanying-premium-plugin-end-of-life-announcement]]
+== Accompanying Premium plugin end-of-life announcement
+
+The following Premium plugin has been announced as reaching its end-of-life:
+
+=== <Premium plugin name eol>
+
+{productname}’s xref:<plugincode>.adoc[<Premium plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.
+
+
+[[accompanying-open-source-plugin-end-of-life-announcement]]
+== Accompanying open source plugin end-of-life announcement
+
+The following open source plugin has been announced as reaching its end-of-life:
+
+=== <Open source plugin name eol>
+
+{productname}’s xref:<plugincode>.adoc[<Open source plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.
+
+
+[[accompanying-enhanced-skins-and-icon-packs-changes]]
+== Accompanying Enhanced Skins & Icon Packs changes
+
+The {productname} {release-version} release includes an accompanying release of the **Enhanced Skins & Icon Packs**.
+
+=== Enhanced Skins & Icon Packs
+
+The **Enhanced Skins & Icon Packs** release includes the following updates:
+
+The **Enhanced Skins & Icon Packs** were rebuilt to pull in the changes also incorporated into the default {productname} {release-version} skin, Oxide.
+
+For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-and-icon-packs.adoc[Enhanced Skins & Icon Packs].
+
+
+[[improvements]]
+== Improvements
+
+{productname} {release-version} also includes the following improvement<s>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[additions]]
+== Additions
+
+{productname} {release-version} also includes the following addition<s>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[changes]]
+== Changes
+
+{productname} {release-version} also includes the following change<s>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[removed]]
+== Removed
+
+{productname} {release-version} also includes the following removal<s>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[bug-fixes]]
+== Bug fixes
+
+{productname} {release-version} also includes the following bug fix<es>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[security-fixes]]
+== Security fixes
+
+{productname} {release-version} includes <a fix | fixes for the following security issue<s>:
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
+
+
+[[deprecated]]
+== Deprecated
+
+{productname} {release-version} includes the following deprecation<s>:
+
+=== The `<plugin>` configuration property, `<name>`, has been deprecated
+
+// placeholder here.
+
+
+[[known-issues]]
+== Known issues
+
+This section describes issues that users of {productname} {release-version} may encounter and possible workarounds for these issues.
+
+There <is one | are <number> known issue<s> in {productname} {release-version}.
+
+=== <TINY-vwxyz 1 changelog entry>
+// #TINY-vwxyz1
+
+// CCFR here.
\ No newline at end of file
diff --git a/modules/ROOT/pages/changelog.adoc b/modules/ROOT/pages/changelog.adoc
index 6f8dca6cdd..1a9f1a4e36 100644
--- a/modules/ROOT/pages/changelog.adoc
+++ b/modules/ROOT/pages/changelog.adoc
@@ -5,6 +5,10 @@
 
 NOTE: This is the {productname} Community version changelog. For information about the latest {cloudname} or {enterpriseversion} Release, see: xref:release-notes.adoc[{productname} Release Notes].
 
+== xref:8.10.2-release-notes.adoc[8.10.2 - <YYYY-MM-DD>]
+
+//TODO
+
 == xref:8.10.1-release-notes.adoc[8.10.1 - 2026-10-28]
 
 ### Fixed
diff --git a/modules/ROOT/pages/release-notes.adoc b/modules/ROOT/pages/release-notes.adoc
index 8523c76b91..01f8d434fa 100644
--- a/modules/ROOT/pages/release-notes.adoc
+++ b/modules/ROOT/pages/release-notes.adoc
@@ -9,6 +9,12 @@ This section lists the releases for {productname} {productmajorversion} and the
 
 [cols="1,1"]
 |===
+a|
+[.lead]
+xref:8.10.2-release-notes.adoc#overview[{productname} 8.10.2]
+
+Release notes for {productname} 8.10.2
+
 a|
 [.lead]
 xref:8.10.1-release-notes.adoc#overview[{productname} 8.10.1]
@@ -165,5 +171,5 @@ xref:8.0-release-notes.adoc#overview[{productname} 8.0.0]
 Release notes for {productname} 8.0.0
 
 // Uncomment the dummy cell when the number of cells in the table is odd to ensure the table renders correctly.
-// a|
+a|
 |===

From 1a28249d26fa5927f98ec1e218024b1ea24fd00d Mon Sep 17 00:00:00 2001
From: Karl Kemister-Sheppard <karlkemistersheppard@gmail.com>
Date: Wed, 11 Nov 2026 12:22:04 +1000
Subject: [PATCH 2/2] TINYDOC-3692 - TinyMCE 8.10.2 Release Documentation and
 Community Changelog (#4417)

* TINYDOC-3692 - Populate TinyMCE 8.10.2 release date

* TINYDOC-3692: Long item text in dialog listboxes overflowed the dialog. (#4436)

* TINYDOC-3692: The image dialog got stuck on "Uploading image" when an empty or unreadable file was selected on the Upload tab. (#4434)

* TINYDOC-3692: Leaving a list with Enter copied the list item's styles onto the new paragraph. (#4433)

* TINYDOC-3692: Following an anchor link to a target inside a collapsed `details` element, such as a closed accordion, now expands it, as browsers do when navigating to an in-page link. (#4424)

* TINYDOC-3692: Following an anchor link to a target inside a collapsed `details` element, such as a closed accordion, now expands it, as browsers do when navigating to an in-page link.

* TINYDOC-3692: Remove the native browser comparison from the TINYMCE-14737 release note.

* TINYDOC-3692: Words inside a `script` element were spellchecked when the `script` was the only content of the editor. (#4431)

* TINYDOC-3692: Node positioned context toolbars repositioned above the editor when the node width was less than the toolbar. (#4430)

* TINYDOC-3692: Underline applied around subscript or superscript text was drawn at the baseline of the surrounding text instead of under the subscript or superscript text. (#4427)

* TINYDOC-3692: Underline applied around subscript or superscript text was drawn at the baseline of the surrounding text instead of under the subscript or superscript text.

* Update modules/ROOT/pages/8.10.2-release-notes.adoc

Co-authored-by: Tomasz Jakut <vepomoc@gmail.com>

---------

Co-authored-by: Tomasz Jakut <vepomoc@gmail.com>

* TINYDOC-3692: The review sidebar could get stuck initializing when it was opened before the TinyMCE AI interface finished loading, for example by using the sidebar_show option. (#4438)

* TINYDOC-3692: A new line inside an indented TD prevented the `Decrease Indent` of the content. (#4423)

* TINYDOC-3692: Image and table resize handles are now hidden from screen readers with `aria-hidden="true"`. (#4425)

* TINYDOC-3707: Document how Format Painter copies inline styles on block elements and applies block formats, and add the formatpainter menu item. (#4439)

* TINYDOC-3692: Block formats were not applied when the selection covered the entire content of a single block. (#4432)

* TINYDOC-3692: Format Painter did not copy inline styles, such as text color, background color or font size, applied directly to block elements. (#4437)

* TINYDOC-3692: pre-release cleanup.

* TINYDOC-3692: add changelog.

* TINYDOC-3692: api-version bump to 8.10.2.

---------

Co-authored-by: Tomasz Jakut <vepomoc@gmail.com>
---
 .api-version                                  |   2 +-
 modules/ROOT/nav.adoc                         |  11 --
 modules/ROOT/pages/8.10.2-release-notes.adoc  | 184 +++++++-----------
 .../pages/apis/tinymce.dom.selection.adoc     |  26 ++-
 modules/ROOT/pages/apis/tinymce.editor.adoc   |  23 ++-
 modules/ROOT/pages/available-menu-items.adoc  |   5 +
 modules/ROOT/pages/changelog.adoc             |  24 ++-
 modules/ROOT/pages/formatpainter.adoc         |  25 ++-
 .../formatpainter_ignored_formats.adoc        |   2 +
 .../formatpainter-menu-items.adoc             |   6 +
 10 files changed, 173 insertions(+), 135 deletions(-)
 create mode 100644 modules/ROOT/partials/menu-item-ids/formatpainter-menu-items.adoc

diff --git a/.api-version b/.api-version
index 2eb8a97206..dd78a70785 100644
--- a/.api-version
+++ b/.api-version
@@ -1 +1 @@
-8.10.1
\ No newline at end of file
+8.10.2
\ No newline at end of file
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 5fbea81874..f7d5b3f91a 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -433,20 +433,9 @@
 ** xref:release-notes.adoc[Release notes for {productname}]
 *** {productname} 8.10.2
 **** xref:8.10.2-release-notes.adoc#overview[Overview]
-**** xref:8.10.2-release-notes.adoc#new-premium-plugin<s>[New Premium Plugin<s>]
-**** xref:8.10.2-release-notes.adoc#new-open-source-plugin<s>[New Open Source Plugin<s>]
 **** xref:8.10.2-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes]
-**** xref:8.10.2-release-notes.adoc#accompanying-premium-plugin-end-of-life-announcement[Accompanying Premium Plugin end-of-life announcement]
-**** xref:8.10.2-release-notes.adoc#accompanying-open-source-plugin-end-of-life-announcement[Accompanying Open Source Plugin end-of-life announcement]
-**** xref:8.10.2-release-notes.adoc#accompanying-enhanced-skins-and-icon-packs-changes[Accompanying Enhanced Skins & Icon Packs changes]
-**** xref:8.10.2-release-notes.adoc#improvements[Improvements]
 **** xref:8.10.2-release-notes.adoc#additions[Additions]
-**** xref:8.10.2-release-notes.adoc#changes[Changes]
-**** xref:8.10.2-release-notes.adoc#removed[Removed]
 **** xref:8.10.2-release-notes.adoc#bug-fixes[Bug fixes]
-**** xref:8.10.2-release-notes.adoc#security-fixes[Security fixes]
-**** xref:8.10.2-release-notes.adoc#deprecated[Deprecated]
-**** xref:8.10.2-release-notes.adoc#known-issues[Known issues]
 *** {productname} 8.10.1
 **** xref:8.10.1-release-notes.adoc#overview[Overview]
 **** xref:8.10.1-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes]
diff --git a/modules/ROOT/pages/8.10.2-release-notes.adoc b/modules/ROOT/pages/8.10.2-release-notes.adoc
index 5a58bcbba0..fef2ff3f1f 100644
--- a/modules/ROOT/pages/8.10.2-release-notes.adoc
+++ b/modules/ROOT/pages/8.10.2-release-notes.adoc
@@ -2,7 +2,7 @@
 :release-version: 8.10.2
 :navtitle: {productname} {release-version}
 :description: Release notes for {productname} {release-version}
-:keywords: releasenotes, new, changes, bugfixes
+:keywords: releasenotes, anew, changes, bugfixes, additions
 :page-toclevels: 1
 
 include::partial$misc/admon-releasenotes-for-stable.adoc[]
@@ -11,47 +11,11 @@ include::partial$misc/admon-releasenotes-for-stable.adoc[]
 [[overview]]
 == Overview
 
-{productname} {release-version} was released for {enterpriseversion} and {cloudname} on <weekday>, <month> <DD>^<st|nd|rd|th>^, <YYYY>. These release notes provide an overview of the changes for {productname} {release-version}, including:
+{productname} {release-version} was released for {enterpriseversion} and {cloudname} on Wednesday, November 11^th^, 2026. These release notes provide an overview of the changes for {productname} {release-version}, including:
 
-// Remove sections and section boilerplates as necessary.
-// Pluralise as necessary or remove the placeholder plural marker.
-* xref:new-premium-plugin<s>[New Premium plugin<s>]
-* xref:new-open-source-plugin<s>[New Open Source plugin<s>]
 * xref:accompanying-premium-plugin-changes[Accompanying Premium plugin changes]
-* xref:accompanying-premium-plugin-end-of-life-announcement[Accompanying Premium plugin end-of-life announcement]
-* xref:accompanying-open-source-plugin-end-of-life-announcement[Accompanying open source plugin end-of-life-announcement]
-* xref:accompanying-enhanced-skins-and-icon-packs-changes[Accompanying Enhanced Skins & Icon Packs changes]
-* xref:improvements[Improvements]
 * xref:additions[Additions]
-* xref:changes[Changes]
 * xref:bug-fixes[Bug fixes]
-* xref:security-fixes[Security fixes]
-* xref:deprecated[Deprecated]
-* xref:known-issues[Known issues]
-
-
-[[new-premium-plugin<s>]]
-== New Premium plugin<s>
-
-The following new Premium plugin was released alongside {productname} {release-version}.
-
-=== <Premium plugin name>
-
-The new Premium plugin, **<Premium plugin name>** // description here.
-
-For information on the **<Premium plugin name>** plugin, see xref:<plugincode>.adoc[<Premium plugin name>].
-
-
-[[new-open-source-plugin]]
-== New Open Source plugin
-
-The following new Open Source plugin was released alongside {productname} {release-version}.
-
-=== <Open source plugin name>
-
-The new open source plugin, **<Open source plugin name>** // description here.
-
-For information on the **<Open source plugin name>** plugin, see xref:<plugincode>.adoc[<Open source plugin name>].
 
 
 [[accompanying-premium-plugin-changes]]
@@ -59,137 +23,129 @@ For information on the **<Open source plugin name>** plugin, see xref:<plugincod
 
 The following premium plugin updates were released alongside {productname} {release-version}.
 
-=== <Premium plugin name 1> <Premium plugin name 1 version>
+=== Format Painter
 
-The {productname} {release-version} release includes an accompanying release of the **<Premium plugin name 1>** premium plugin.
+The {productname} {release-version} release includes an accompanying release of the **Format Painter** premium plugin.
 
-**<Premium plugin name 1>** <Premium plugin name 1 version> includes the following <fixes, changes, improvements>.
+**Format Painter** includes the following fix.
 
-==== <Premium plugin name 1 change 1>
+==== Format Painter did not copy inline styles, such as text color, background color or font size, applied directly to block elements
+// #TINYMCE-14938
 
-// CCFR here.
+Previously, the **Format Painter** plugin did not copy inline styles applied directly to a block element, such as a `+color+` style on an `+h2+` element. When a user copied the formatting of text inside a red heading and applied it to a word in a paragraph, the word did not turn red. Users had to apply the missing styles again manually.
 
-For information on the **<Premium plugin name 1>** plugin, see: xref:<plugincode>.adoc[<Premium plugin name 1>].
+In {productname} {release-version}, the **Format Painter** plugin also copies inline styles applied directly to a block element when those styles match an inline format registered in the editor, such as text color, background color, font family, or font size. The plugin applies these styles to the goal content in a `+span+` element. When the same style is set on more than one element around the source content, the plugin uses the value from the closest element. The plugin does not copy formats listed in the xref:formatpainter.adoc#formatpainter_ignored_formats[`+formatpainter_ignored_formats+`] option.
 
+For information on the **Format Painter** plugin, see: xref:formatpainter.adoc[Format Painter].
 
-[[accompanying-premium-plugin-end-of-life-announcement]]
-== Accompanying Premium plugin end-of-life announcement
+==== Block formats were not applied when the selection covered the entire content of a single block.
+// #TINYMCE-14939
 
-The following Premium plugin has been announced as reaching its end-of-life:
+Previously, the **Format Painter** plugin applied block formats, such as a heading, only when the selection was collapsed or spanned more than one block. When a user selected the entire content of a single block and applied the formatting, the plugin applied only the inline formats and did not apply the block format.
 
-=== <Premium plugin name eol>
+In {productname} {release-version}, the **Format Painter** plugin also applies block formats when the selection covers the entire content of a single block. For example, when a user applies the formatting from a heading to a paragraph with its entire content selected, the plugin converts the paragraph to a heading.
 
-{productname}’s xref:<plugincode>.adoc[<Premium plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.
+For information on the **Format Painter** plugin, see: xref:formatpainter.adoc[Format Painter].
 
+=== TinyMCE AI
 
-[[accompanying-open-source-plugin-end-of-life-announcement]]
-== Accompanying open source plugin end-of-life announcement
+The {productname} {release-version} release includes an accompanying release of the **TinyMCE AI** premium plugin.
 
-The following open source plugin has been announced as reaching its end-of-life:
+**TinyMCE AI** includes the following fix.
 
-=== <Open source plugin name eol>
+==== The review sidebar could get stuck initializing when it was opened before the TinyMCE AI interface finished loading, for example by using the `+sidebar_show+` option
+// #TINYMCE-15165
 
-{productname}’s xref:<plugincode>.adoc[<Open source plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.
+Previously, when the xref:tinymceai.adoc#tinymceai_sidebar_type[`+tinymceai_sidebar_type+`] option had its default value of `+'static'+`, the Review sidebar could open before the plugin interface finished loading. For example, setting the xref:customsidebar.adoc#sidebar_show[`+sidebar_show+`] option to `+'tinymceai-review'+` opened the Review sidebar on editor load. The sidebar then displayed the `+Initializing review mode...+` message, and users had to close and reopen the sidebar before they could use it.
 
+In {productname} {release-version}, the **TinyMCE AI** plugin records which sidebar opens while the interface loads and displays that sidebar once loading completes. The Review sidebar and the Chat sidebar open as expected on editor load, including when a user switches between them or closes one before the interface finishes loading.
 
-[[accompanying-enhanced-skins-and-icon-packs-changes]]
-== Accompanying Enhanced Skins & Icon Packs changes
+For information on the **TinyMCE AI** plugin, see: xref:tinymceai.adoc[TinyMCE AI].
 
-The {productname} {release-version} release includes an accompanying release of the **Enhanced Skins & Icon Packs**.
+=== Spell Checker
 
-=== Enhanced Skins & Icon Packs
+The {productname} {release-version} release includes an accompanying release of the **Spell Checker** premium plugin.
 
-The **Enhanced Skins & Icon Packs** release includes the following updates:
+**Spell Checker** includes the following fix.
 
-The **Enhanced Skins & Icon Packs** were rebuilt to pull in the changes also incorporated into the default {productname} {release-version} skin, Oxide.
+==== Words inside a `script` element were spellchecked when the `script` was the only content of the editor.
+// #TINYMCE-15087
 
-For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-and-icon-packs.adoc[Enhanced Skins & Icon Packs].
+Previously, when a `+<script>+` element was the only content of the editor, the **Spell Checker** plugin sent the words inside the element for spell checking. The plugin skipped `+<script>+` elements elsewhere in the content, but did not skip the element when all of the text to check was inside the element. As a result, the plugin checked script code as if it were editor content.
 
+In {productname} {release-version}, the **Spell Checker** plugin skips the content of a `+<script>+` element, including when the element is the only content of the editor. The plugin checks only the editor content outside the element.
 
-[[improvements]]
-== Improvements
-
-{productname} {release-version} also includes the following improvement<s>:
-
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
-
-// CCFR here.
+For information on the **Spell Checker** plugin, see: xref:introduction-to-tiny-spellchecker.adoc[Spell Checker].
 
 
 [[additions]]
 == Additions
 
-{productname} {release-version} also includes the following addition<s>:
-
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
-
-// CCFR here.
-
+{productname} {release-version} also includes the following addition:
 
-[[changes]]
-== Changes
+=== New `getFullySelectedBlocks` function added to `tinymce.selection` which returns the blocks fully covered by the selection.
+// #TINYMCE-14939
 
-{productname} {release-version} also includes the following change<s>:
+{productname} {release-version} adds the xref:apis/tinymce.dom.selection.adoc#getFullySelectedBlocks[`+editor.selection.getFullySelectedBlocks()+`] method. The method returns an array of the block elements whose entire content is inside the current selection. The array does not include blocks that are partially selected. The method returns an empty array when the selection is collapsed.
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
-
-// CCFR here.
 
+[[bug-fixes]]
+== Bug fixes
 
-[[removed]]
-== Removed
+{productname} {release-version} also includes the following bug fixes:
 
-{productname} {release-version} also includes the following removal<s>:
+=== Image and table resize handles are now hidden from screen readers with `+aria-hidden="true"+`
+// #TINYMCE-14927
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
+Previously, the resize handles that appear when an image or table is selected were not hidden from assistive technologies. The same applied to the label that shows the new dimensions during a resize. Screen readers could reach and announce these elements, even though they exist only as visual aids.
 
-// CCFR here.
+In {productname} {release-version}, the resize handles and the other elements shown during a resize have the `+aria-hidden="true"+` attribute, so screen readers ignore them. Image and table dimensions can still be changed without a mouse from the *Insert/Edit Image* and *Table Properties* dialogs.
 
+=== A new line inside an indented TD prevented the `+Decrease Indent+` of the content
+// #TINYMCE-8693
 
-[[bug-fixes]]
-== Bug fixes
+Previously, when content placed directly inside a table cell was indented, {productname} applied the indentation to the table cell (`+<td>+`) element. When a new line was then added in the cell, for example by pressing Enter, {productname} wrapped the content in paragraph (`+<p>+`) elements that did not carry the indentation. As a result, the *Decrease indent* toolbar button was disabled and the indented content could not be outdented.
 
-{productname} {release-version} also includes the following bug fix<es>:
+In {productname} {release-version}, when the content of a table cell is indented, {productname} wraps the inline content in paragraph elements and applies the indentation to those paragraphs instead of to the cell. The new line keeps the indentation, and the *Decrease indent* toolbar button remains enabled, so the content can be outdented as expected.
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
+=== Underline applied around subscript or superscript text was drawn at the baseline of the surrounding text instead of under the subscript or superscript text
+// #TINYMCE-15001
 
-// CCFR here.
+Previously, when underline and subscript or superscript formatting were combined, {productname} could place the subscript (`+<sub>+`) or superscript (`+<sup>+`) element inside the underline element. Browsers then drew the underline at the baseline of the surrounding text. Under subscript text, the underline appeared only in the gaps between words. Under superscript text, the underline sat below the raised text instead of directly under it. This output did not match how desktop word processors underline subscript and superscript text.
 
+In {productname} {release-version}, the editor moves the underline inside the `+<sub>+` and `+<sup>+` elements, as it already does for strikethrough. The underline now sits directly under subscript and superscript text, whichever format is applied first. The same correction applies to underline `+<span>+` and `+<u>+` elements when subscript or superscript content is inserted into underlined text. The editor does not change underline applied around text with a different font size.
 
-[[security-fixes]]
-== Security fixes
+=== Node positioned context toolbars repositioned above the editor when the node width was less than the toolbar.
+// #TINYMCE-13900
 
-{productname} {release-version} includes <a fix | fixes for the following security issue<s>:
+Previously, in inline mode, a context toolbar that used `+position: 'node'+` moved above the editor when the selected node was narrower than the toolbar. For example, when a user resized an image to a width smaller than the context toolbar, the toolbar jumped from the image to a position above the editor. The toolbar then appeared detached from the node it applied to.
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
+In {productname} {release-version}, a context toolbar that uses `+position: 'node'+` stays attached to the selected node, even when the node is narrower than the toolbar. When a user resizes an image to a width narrower than the context toolbar, the toolbar remains above the image.
 
-// CCFR here.
+=== Following an anchor link to a target inside a collapsed `+details+` element, such as a closed accordion, now expands it, as browsers do when navigating to an in-page link
+// #TINYMCE-14737
 
+Previously, when a link to an anchor inside a closed accordion was followed, {productname} scrolled to the target but left the accordion closed, so the target content stayed hidden.
 
-[[deprecated]]
-== Deprecated
+In {productname} {release-version}, the editor opens every closed `+<details>+` element that hides the target, including accordions, before scrolling to it. This applies when a link is followed with Ctrl+click (Cmd+click on macOS), with the Alt+Enter keyboard shortcut (⌥+Enter on macOS), with the *Open link* context menu item or toolbar button, or with a click in a disabled editor. For the full list of editor shortcuts, see xref:keyboard-shortcuts.adoc#editor-keyboard-shortcuts[Editor keyboard shortcuts]. In design mode, the accordion stays open in the editor content. In read-only and disabled modes, the accordion opens on screen only, and the editor content does not change.
 
-{productname} {release-version} includes the following deprecation<s>:
+=== Leaving a list with Enter copied the list item's styles onto the new paragraph.
+// #TINYMCE-13035
 
-=== The `<plugin>` configuration property, `<name>`, has been deprecated
+Previously, when a user pressed Enter on an empty list item to leave a list, {productname} copied the styles of the list item to the new paragraph. For example, when a user applied bold to the entire content of a list item and pressed Enter twice to leave the list, the new paragraph inherited the `+font-weight+` style. Text typed in the paragraph stayed bold after the user turned bold off, and applying bold again added the bold format a second time. Color, font size, and font family set on a list item carried over to the new paragraph in the same way.
 
-// placeholder here.
+In {productname} {release-version}, the editor copies the styles of an empty list item only when the new block is also a list item. A paragraph created by leaving a list no longer inherits the list item styles, so bold, italic, and other formats toggle as expected.
 
+=== The image dialog got stuck on "Uploading image" when an empty or unreadable file was selected on the Upload tab.
+// #TINYMCE-7202
 
-[[known-issues]]
-== Known issues
+Previously, when a user selected an empty file, such as a 0-byte `+.png+` file, on the Upload tab of the image dialog, the dialog stayed on the "Uploading image" message, and the browser console showed an error. The dialog remained blocked and displayed no message about the problem.
 
-This section describes issues that users of {productname} {release-version} may encounter and possible workarounds for these issues.
+In {productname} {release-version}, when the image dialog cannot read the selected file or convert it to image data, the dialog cancels the upload and displays a "Failed to upload image" alert. After the user closes the alert, the dialog accepts input again, and the user can select a different file.
 
-There <is one | are <number> known issue<s> in {productname} {release-version}.
+=== Long item text in dialog listboxes overflowed the dialog
+// #TINYMCE-14261
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
+Previously, the menu of a listbox in a dialog grew to fit the longest item in the list. When an item had long text, such as an anchor with a long `+id+` in the *Anchors* field of the *Insert/Edit Link* dialog, the open menu extended past the edge of the dialog. The selected value also overflowed the field. The dialog displayed a horizontal scrollbar and the layout broke, which made the dialog difficult to read and use.
 
-// CCFR here.
\ No newline at end of file
+In {productname} {release-version}, the menu of a dialog listbox matches the width of the field, and long items wrap onto several lines. When the selected value is too long for the field, the listbox truncates the value with an ellipsis. Long listbox items no longer break the dialog layout or add a horizontal scrollbar.
diff --git a/modules/ROOT/pages/apis/tinymce.dom.selection.adoc b/modules/ROOT/pages/apis/tinymce.dom.selection.adoc
index 2a2c7cd0a3..f8d035fdf4 100644
--- a/modules/ROOT/pages/apis/tinymce.dom.selection.adoc
+++ b/modules/ROOT/pages/apis/tinymce.dom.selection.adoc
@@ -1,7 +1,7 @@
 = tinymce.dom.Selection
 :navtitle: tinymce.dom.Selection
 :description: This class handles text and control selection it&#x27;s an crossbrowser utility class. Consult the TinyMCE API Documentation for more details and examples on how to use this class.
-:keywords: Selection, collapse, expand, getBookmark, getContent, getEnd, getNode, getRng, getSel, getStart, isCollapsed, isEditable, moveToBookmark, select, selectorChanged, setContent, setCursorLocation, setNode, setRng
+:keywords: Selection, collapse, expand, getBookmark, getContent, getEnd, getFullySelectedBlocks, getNode, getRng, getSel, getStart, isCollapsed, isEditable, moveToBookmark, select, selectorChanged, setContent, setCursorLocation, setNode, setRng
 :moxie-type: api
 
 This class handles text and control selection it's an crossbrowser utility class. Consult the TinyMCE API Documentation for more details and examples on how to use this class.
@@ -37,6 +37,8 @@ can then be used to restore the selection after some content modification to the
 |xref:#getContent[getContent()]|Returns the selected contents using the DOM serializer passed in to this class.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
 |xref:#getEnd[getEnd()]|Returns the end element of a selection range. If the end is in a text
 node the parent element will be returned.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
+|xref:#getFullySelectedBlocks[getFullySelectedBlocks()]|Returns the blocks whose whole content is inside the current selection. Blocks that are only
+partially selected are not included, and a collapsed selection returns an empty array.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
 |xref:#getNode[getNode()]|Returns the currently selected element or the common ancestor element for both start and end of the selection.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
 |xref:#getRng[getRng()]|Returns the browsers internal range object.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
 |xref:#getSel[getSel()]|Returns the browsers internal selection object.|`xref:apis/tinymce.dom.selection.adoc[Selection]`
@@ -187,6 +189,28 @@ node the parent element will be returned.
 
 '''
 
+[[getFullySelectedBlocks]]
+=== getFullySelectedBlocks()
+[source, javascript]
+----
+getFullySelectedBlocks(): Array
+----
+Returns the blocks whose whole content is inside the current selection. Blocks that are only
+partially selected are not included, and a collapsed selection returns an empty array.
+
+==== Examples
+[source, javascript]
+----
+// Alerts the number of blocks that are entirely selected
+alert(tinymce.activeEditor.selection.getFullySelectedBlocks().length);
+----
+
+==== Return value
+
+* `Array` - Array with the fully selected block elements.
+
+'''
+
 [[getNode]]
 === getNode()
 [source, javascript]
diff --git a/modules/ROOT/pages/apis/tinymce.editor.adoc b/modules/ROOT/pages/apis/tinymce.editor.adoc
index db1ff1852d..5f0b4ef4c5 100644
--- a/modules/ROOT/pages/apis/tinymce.editor.adoc
+++ b/modules/ROOT/pages/apis/tinymce.editor.adoc
@@ -148,7 +148,10 @@ so all events etc that method has will get dispatched as well.|`xref:apis/tinymc
 the different cleanup rules options.
 
 
-__Note: The content return value was deprecated in TinyMCE 6.0 and has been marked for removal in TinyMCE 7.0.__|`xref:apis/tinymce.editor.adoc[Editor]`
+__Note: This method does not add an undo level. To add one, call `editor.undoManager.add()` after setting the content.__
+
+
+__Note: To change the content before it is set, update the `content` property in a `BeforeSetContent` event handler.__|`xref:apis/tinymce.editor.adoc[Editor]`
 |xref:#setDirty[setDirty()]|Explicitly sets the dirty state. This will fire the dirty event if the editor dirty state is changed from false to true
 by invoking this method.|`xref:apis/tinymce.editor.adoc[Editor]`
 |xref:#setEditableRoot[setEditableRoot()]|Changes the editable state of the editor's root element.|`xref:apis/tinymce.editor.adoc[Editor]`
@@ -982,13 +985,16 @@ so all events etc that method has will get dispatched as well.
 === setContent()
 [source, javascript]
 ----
-setContent(content: String, args: Object)
+setContent(content: String, args: Object, args.no_events: Boolean, args.no_selection: Boolean)
 ----
 Sets the specified content to the editor instance, this will cleanup the content before it gets set using
 the different cleanup rules options.
 
 
-__Note: The content return value was deprecated in TinyMCE 6.0 and has been marked for removal in TinyMCE 7.0.__
+__Note: This method does not add an undo level. To add one, call `editor.undoManager.add()` after setting the content.__
+
+
+__Note: To change the content before it is set, update the `content` property in a `BeforeSetContent` event handler.__
 
 ==== Examples
 [source, javascript]
@@ -1001,12 +1007,21 @@ tinymce.get('my_editor').setContent(data);
 
 // Sets the content of the activeEditor editor using the specified format
 tinymce.activeEditor.setContent('<p>Some html</p>', { format: 'html' });
+
+// Sets the content without dispatching the BeforeSetContent and SetContent events
+tinymce.activeEditor.setContent('<p>Some html</p>', { no_events: true });
+
+// Sets the content and adds an undo level so the change can be undone
+tinymce.activeEditor.setContent('<p>Some html</p>');
+tinymce.activeEditor.undoManager.add();
 ----
 
 ==== Parameters
 
-* `content (String)` - Content to set to editor, normally HTML contents but can be other formats as well.
+* `content (String)` - Content to set to editor, normally HTML contents.
 * `args (Object)` - Optional content object, this gets passed around through the whole set process.
+* `args.no_events (Boolean)` - If true, the BeforeSetContent and SetContent events are not dispatched. Defaults to false.
+* `args.no_selection (Boolean)` - If true, the selection is not moved to the start of the new content. Defaults to false.
 
 '''
 
diff --git a/modules/ROOT/pages/available-menu-items.adoc b/modules/ROOT/pages/available-menu-items.adoc
index de4614995d..45f2e4be74 100644
--- a/modules/ROOT/pages/available-menu-items.adoc
+++ b/modules/ROOT/pages/available-menu-items.adoc
@@ -115,6 +115,11 @@ include::partial$misc/plugin-menu-item-id-boilerplate.adoc[]
 :plugincode: footnotes
 include::partial$misc/plugin-menu-item-id-boilerplate.adoc[]
 
+:plugincategory: premium
+:pluginname: Format Painter
+:plugincode: formatpainter
+include::partial$misc/plugin-menu-item-id-boilerplate.adoc[]
+
 :plugincategory: premium
 :pluginname: Full Page HTML
 :plugincode: fullpagehtml
diff --git a/modules/ROOT/pages/changelog.adoc b/modules/ROOT/pages/changelog.adoc
index 1a9f1a4e36..ae36a2557b 100644
--- a/modules/ROOT/pages/changelog.adoc
+++ b/modules/ROOT/pages/changelog.adoc
@@ -5,9 +5,29 @@
 
 NOTE: This is the {productname} Community version changelog. For information about the latest {cloudname} or {enterpriseversion} Release, see: xref:release-notes.adoc[{productname} Release Notes].
 
-== xref:8.10.2-release-notes.adoc[8.10.2 - <YYYY-MM-DD>]
+== xref:8.10.2-release-notes.adoc[8.10.2 - 2026-11-11]
 
-//TODO
+### Added
+* New `getFullySelectedBlocks` function added to `tinymce.selection` which returns the blocks fully covered by the selection.
+// #TINYMCE-14939
+
+### Fixed
+* A new line inside an indented TD prevented the `Decrease Indent` of the content.
+// #TINYMCE-8693
+* Image and table resize handles are now hidden from screen readers with `aria-hidden="true"`.
+// #TINYMCE-14927
+* Following an anchor link to a target inside a collapsed `details` element, such as a closed accordion, now expands it, as browsers do when navigating to an in-page link.
+// #TINYMCE-14737
+* Underline applied around subscript or superscript text was drawn at the baseline of the surrounding text instead of under the subscript or superscript text.
+// #TINYMCE-15001
+* Node positioned context toolbars repositioned above the editor when the node width was less than the toolbar.
+// #TINYMCE-13900
+* The image dialog got stuck on "Uploading image" when an empty or unreadable file was selected on the Upload tab. An error message is now shown and the dialog can be used again.
+// #TINYMCE-7202
+* Leaving a list with Enter copied the list item's styles onto the new paragraph.
+// #TINYMCE-13035
+* Long item text in dialog listboxes overflowed the dialog.
+// #TINYMCE-14261
 
 == xref:8.10.1-release-notes.adoc[8.10.1 - 2026-10-28]
 
diff --git a/modules/ROOT/pages/formatpainter.adoc b/modules/ROOT/pages/formatpainter.adoc
index 407e5e3b75..12957656f9 100644
--- a/modules/ROOT/pages/formatpainter.adoc
+++ b/modules/ROOT/pages/formatpainter.adoc
@@ -8,7 +8,7 @@
 
 include::partial$misc/admon-premium-plugin.adoc[]
 
-The Format Painter plugin allows a user to copy and paste formatting from one location to another, such as font style and size. The format painter is capable of working with a wide variety of formats such as inline and block formats and styles such as table styles.
+The Format Painter plugin allows a user to copy and paste formatting from one location to another, such as font style and size. The format painter is capable of working with a wide variety of formats such as inline and block formats, table styles, and inline styles applied directly to block elements, such as the text color of a heading.
 
 == Interactive example
 
@@ -57,9 +57,28 @@ The format painter operates in two modes, one for retrieval and one for applicat
 
 TIP: The format painter retains the formatting after application making it possible to apply the same formatting multiple times by using the `+Ctrl+Alt+V+` keyboard shortcut.
 
+[[how-formats-are-copied-and-applied]]
+=== How formats are copied and applied
+
+*Inline styles on block elements*
+
+When the source content is inside a block element that has inline styles applied directly to it, such as `+<h2 style="color: #e03e2d;">+`, the format painter copies each style that matches a registered inline format. The default inline formats that match styles are `+forecolor+` (`+color+`), `+hilitecolor+` (`+background-color+`), `+fontname+` (`+font-family+`), and `+fontsize+` (`+font-size+`). The format painter applies these styles to the goal content as inline formatting in a `+span+` element. When more than one element around the source content sets the same style, the format painter uses the value from the closest element.
+
+Custom formats registered with the xref:content-formatting.adoc#formats[`+formats+`] option are also copied this way when they are inline formats whose styles use only variable values, for example `+{ inline: 'span', styles: { color: '%value' } }+`. Formats listed in xref:#formatpainter_ignored_formats[`+formatpainter_ignored_formats+`] are not copied.
+
+*Block formats*
+
+The format painter applies block formats, such as a heading, when the goal content is one of the following:
+
+* The cursor is placed in a block, with no content selected.
+* The selection crosses a block boundary.
+* The selection covers the entire content of a single block, such as a whole paragraph or a whole list item.
+
+When the selection covers only part of a block, the format painter applies inline formats only.
+
 == Options
 
-The format painter acts upon all xref:content-formatting.adoc#formats[`+formats+`] registered in the editor. In addition to any standard formatting, it will treat *lists* as a block format whenever the xref:lists.adoc[`+lists plugin+`] is made available.
+The format painter acts upon all xref:content-formatting.adoc#formats[`+formats+`] registered in the editor. In addition to any standard formatting, it will treat *lists* as a block format whenever the xref:lists.adoc[`+lists plugin+`] is made available. For how the format painter copies inline styles applied to block elements and when it applies block formats, see xref:#how-formats-are-copied-and-applied[How formats are copied and applied].
 
 include::partial$configuration/formatpainter_formats.adoc[leveloffset=+1]
 
@@ -67,6 +86,8 @@ include::partial$configuration/formatpainter_ignored_formats.adoc[leveloffset=+1
 
 include::partial$misc/plugin-toolbar-button-id-boilerplate.adoc[]
 
+include::partial$misc/plugin-menu-item-id-boilerplate.adoc[]
+
 == Commands
 
 The Format Painter plugin provides the following {productname} commands.
diff --git a/modules/ROOT/partials/configuration/formatpainter_ignored_formats.adoc b/modules/ROOT/partials/configuration/formatpainter_ignored_formats.adoc
index 23fa8d1b01..fb4b76840c 100644
--- a/modules/ROOT/partials/configuration/formatpainter_ignored_formats.adoc
+++ b/modules/ROOT/partials/configuration/formatpainter_ignored_formats.adoc
@@ -3,6 +3,8 @@
 
 This option makes it possible to block the unwanted formats in the format painter.
 
+Ignored formats are also not copied from inline styles applied directly to block elements. For example, adding `+forecolor+` to this option stops the format painter copying the text color of a heading or paragraph. For more information, see xref:formatpainter.adoc#how-formats-are-copied-and-applied[How formats are copied and applied].
+
 *Type:* `+String+`
 
 *Default value:* `+'link,address,removeformat,formatpainter_removeformat'+`
diff --git a/modules/ROOT/partials/menu-item-ids/formatpainter-menu-items.adoc b/modules/ROOT/partials/menu-item-ids/formatpainter-menu-items.adoc
new file mode 100644
index 0000000000..81277f8ae3
--- /dev/null
+++ b/modules/ROOT/partials/menu-item-ids/formatpainter-menu-items.adoc
@@ -0,0 +1,6 @@
+[cols="1,1,2",options="header"]
+|===
+|Menu item identifier |xref:menus-configuration-options.adoc#example-the-tinymce-default-menu-items[Default Menu Location] |Description
+
+|`+formatpainter+` |_Not Applicable_ |Enables and disables format painting.
+|===