DOC-3305: Fix various issues found across major versions.

Author: kemister85

modules/ROOT/pages/migration-from-4x-to-8x.adoc

@@ -264,21 +264,21 @@ The undocumented `editor.documentBaseUrl` property has been removed.
 console.log('documentBaseUrl', editor.documentBaseUrl);
 
 // Use this instead
-console.log('documentBaseURI', editor.documentBaseURI.getURI());
+console.log('documentBaseURI', editor.editorManager.documentBaseURI.getURI());
 ----
 
-TIP: Use `editor.documentBaseURI.getURI()` for all base URL operations.
+TIP: Use `editor.editorManager.documentBaseURI.getURI()` for all base URL operations.
 
 **Impact**: This change improves URL handling consistency by removing an undocumented API that was not aligned with the documented `documentBaseURI` property.
 
 **Migration steps:**
 
-To update all references of `documentBaseUrl` to the new API, replace any usage of `editor.documentBaseUrl` (or similar) with `editor.documentBaseURI.getURI()`. The property `documentBaseUrl` has been removed, and the correct way to access the document base URL is now through the `documentBaseURI` property, which is a URI object. You can then call `.getURI()` on it to get the string value of the URL.
+To update all references of `documentBaseUrl` to the new API, replace any usage of `editor.documentBaseUrl` (or similar) with `editor.editorManager.documentBaseURI.getURI()`. The property `documentBaseUrl` has been removed, and the correct way to access the document base URL is now through the `editorManager.documentBaseURI` property, which is a URI object. You can then call `.getURI()` on it to get the string value of the URL.
 
 **Migration checklist:**
 
 * [ ] Search your codebase for all instances of `editor.documentBaseUrl`.
-* [ ] Replace them with `tinymce.activeEditor.documentBaseURI.getURI()` (or `editor.documentBaseURI.getURI()` if you have an `editor` reference).
+* [ ] Replace them with `tinymce.activeEditor.editorManager.documentBaseURI.getURI()` (or `editor.editorManager.documentBaseURI.getURI()` if you have an `editor` reference).
 
 ===== skipFocus and skip_focus Consolidation (v8)
 
@@ -293,17 +293,17 @@ The `skipFocus` and `skip_focus` options for the `ToggleToolbarDrawer` command h
 .Example:
 [source,js]
 ----
-// Old TinyMCE 7 usage
-editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true });
-
-// New TinyMCE 8 usage
+// Old approach (deprecated in TinyMCE 8)
 editor.execCommand('ToggleToolbarDrawer', false, { skipFocus: true });
+
+// New approach (recommended)
+editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true });
 ----
 
 **Migration checklist:**
 
 * [ ] Locate all instances of `ToggleToolbarDrawer` command usage
-* [ ] Replace `skip_focus` with `skipFocus` in command options
+* [ ] Replace `skipFocus` with `skip_focus` in command options
 * [ ] Update any custom plugins using this command
 * [ ] Test toolbar drawer behavior after changes
 

modules/ROOT/pages/migration-from-5x-to-8x.adoc

@@ -225,28 +225,29 @@ editor.ui.registry.addAutocompleter('myautocompleter', {
 
 ==== table_responsive_width replaced by table_sizing_mode (v7)
 
+The `table_responsive_width` option has been replaced by xref:table-options.adoc#table_sizing_mode[`table_sizing_mode`] in TinyMCE 7.0.
+
 .Example:
 [source,js]
 ----
 // Old TinyMCE 6 configuration
-editor.ui.registry.addAutocompleter('myautocompleter', {
-  ch: '@',
-  minChars: 2,
-  fetch: function(pattern) {
-    return Promise.resolve(['item1', 'item2']);
-  }
+tinymce.init({
+  selector: "textarea",
+  table_responsive_width: true
 });
 
 // New TinyMCE 7+ configuration
-editor.ui.registry.addAutocompleter('myautocompleter', {
-  trigger: '@',
-  minChars: 2,
-  fetch: function(pattern) {
-    return Promise.resolve(['item1', 'item2']);
-  }
+tinymce.init({
+  selector: "textarea",
+  table_sizing_mode: "responsive"
 });
 ----
-** `table_responsive_width` replaced by xref:table-options.adoc#table_sizing_mode[`table_sizing_mode`].
+
+**Migration checklist:**
+
+* [ ] Replace `table_responsive_width` with `table_sizing_mode` in your configuration
+* [ ] Update the option value to match the new API
+* [ ] Test table responsive behavior
 
 * **Default Changes in TinyMCE 7.0**:
 ** xref:content-filtering.adoc#sandbox-iframes[`sandbox iframes`]: Now defaults to `true` (adds sandbox attribute to iframes)
@@ -306,7 +307,7 @@ Refer to version-specific release notes for changes in toolbar button names and
 
 * `editor.selection.setContent` → `editor.insertContent`
 * `editor.fire()` → `editor.dispatch()`
-* `editor.documentBaseUrl` → `editor.documentBaseURI.getURI()`
+* `editor.documentBaseUrl` → `editor.editorManager.documentBaseURI.getURI()`
 ====
 
 === Licensing Changes (GPL v2+ and Commercial)
@@ -352,7 +353,7 @@ Several API methods have been deprecated or removed across versions 6-8. Key cha
 * **Deprecated in TinyMCE 8**:
 ** `editor.selection.setContent` → Use xref:apis/tinymce.editor.adoc#insertContent[`editor.insertContent`] instead
 ** `editor.fire()` → Use xref:apis/tinymce.editor.adoc#dispatch[`editor.dispatch()`] instead
-** `editor.documentBaseUrl` → Use `editor.documentBaseURI.getURI()` instead
+** `editor.documentBaseUrl` → Use `editor.editorManager.documentBaseURI.getURI()` instead
 
 ==== skipFocus and skip_focus Consolidation (v8)
 
@@ -367,17 +368,17 @@ The `skipFocus` and `skip_focus` options for the `ToggleToolbarDrawer` command h
 .Example:
 [source,js]
 ----
-// Old TinyMCE 7 usage
-editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true });
-
-// New TinyMCE 8 usage
+// Old approach (deprecated in TinyMCE 8)
 editor.execCommand('ToggleToolbarDrawer', false, { skipFocus: true });
+
+// New approach (recommended)
+editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true });
 ----
 
 **Migration checklist:**
 
 * [ ] Locate all instances of `ToggleToolbarDrawer` command usage
-* [ ] Replace `skip_focus` with `skipFocus` in command options
+* [ ] Replace `skipFocus` with `skip_focus` in command options
 * [ ] Update any custom plugins using this command
 * [ ] Test toolbar drawer behavior after changes
 

modules/ROOT/pages/migration-from-5x.adoc

@@ -196,8 +196,7 @@ license_key: "your-license-key"
 
 . **Backup and Prepare**: Ensure comprehensive backups before upgrading.
 . **Update Core Initialization**:
-.. Update `theme`, `skin`, and to refect the new oxide theme and skin.
-... In {productname} 4, there were multiple themes available including 'modern', 'inlite', and 'mobile'. These themes were removed in {productname} 5 and combined into a single responsive theme called "Silver".
+.. Verify `theme` and `skin` settings. In {productname} 5, the Silver theme with Oxide skin was already standard, so no theme changes are required when migrating to v{release-version}.
 .. Update `forced_root_block: false` options to `forced_root_block: "p"`.
 .. Consolidate toolbars.
 .. Review new v{release-version} defaults for security settings.

modules/ROOT/pages/migration-from-6x-to-8x.adoc

@@ -13,49 +13,22 @@ This guide provides a complete migration path from TinyMCE 6 to TinyMCE 8, cover
 
 == Key Changes
 
-=== UI Themes and Skins
-
-The theme and skin system has been updated across versions 7 and 8:
-
-* **Modern Theme**: Replaced by the `silver` theme with `oxide` skin
-* **Lightgray Theme**: Replaced by the `silver` theme with `oxide` skin  
-* **Mobile Theme**: Replaced by the `silver` theme with `oxide` skin
-
-**Migration Steps:**
-
-1. Update theme configuration to use `silver` theme
-2. Update skin configuration to use `oxide` skin
-3. Test UI appearance and functionality
-
-.Example:
-[source,js]
-----
-// Old TinyMCE 6 configuration
-tinymce.init({
-  selector: "textarea",
-  theme: "modern",
-  skin: "lightgray"
-});
-
-// New TinyMCE 7+ configuration
-tinymce.init({
-  selector: "textarea",
-  theme: "silver",
-  skin: "oxide"
-});
-----
-
 === Plugin Ecosystem
 
 The {productname} plugin ecosystem underwent changes starting in version 7.0, with several plugins being removed or reclassified.
 
 * **Removed Plugins** (no longer available as of {productname} 7.0):
 ** `template`: Removed in 7.0. Replaced by the premium xref:advanced-templates.adoc[Templates] plugin.
 
-* **Now Premium Only**:
+* **Now Premium Only** (removed in 6.0, before this migration path):
 ** `imagetools`: Removed in 6.0. Replaced by the premium xref:editimage.adoc[Enhanced Image Editing] feature, available via the `+editimage+` plugin introduced in TinyMCE 6.0.
 ** `textcolor`: Removed in 6.0. Use the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality instead.
 
+[NOTE]
+====
+If you're migrating from TinyMCE 6, these plugins (`imagetools` and `textcolor`) were already removed in version 6.0, so you won't need to migrate them. The sections below are included for reference only, in case you're upgrading from an older version or have legacy code.
+====
+
 ==== Plugin Migration Examples
 
 * `template` (removed in v7):
@@ -223,15 +196,15 @@ The `editor.documentBaseUrl` property has been removed. Use `editor.editorManage
 const baseUrl = editor.documentBaseUrl;
 
 // New approach
-const baseUrl = editor.documentBaseURI.getURI();
+const baseUrl = editor.editorManager.documentBaseURI.getURI();
 ----
 
 **Impact**: This change improves URL handling consistency by removing an undocumented API that was not aligned with the documented `documentBaseURI` property.
 
 **Migration checklist:**
 
 * [ ] Search your codebase for all instances of `editor.documentBaseUrl`.
-* [ ] Replace them with `tinymce.activeEditor.documentBaseURI.getURI()` (or `editor.documentBaseURI.getURI()` if you have an `editor` reference).
+* [ ] Replace them with `tinymce.activeEditor.editorManager.documentBaseURI.getURI()` (or `editor.editorManager.documentBaseURI.getURI()` if you have an `editor` reference).
 
 ==== skipFocus and skip_focus Consolidation
 
@@ -246,23 +219,23 @@ The `skipFocus` and `skip_focus` options for the `ToggleToolbarDrawer` command w
 **Migration Steps:**
 
 1. Locate all instances of `ToggleToolbarDrawer` command usage
-2. Replace `skip_focus` with `skipFocus` in command parameters
+2. Replace `skipFocus` with `skip_focus` in command parameters
 3. Test toolbar drawer behavior
 
 .Example:
 [source,js]
 ----
-// Old approach
-editor.execCommand('ToggleToolbarDrawer', false, { skip_focus: true });
-
-// New approach
+// Old approach (deprecated in TinyMCE 8)
 editor.execCommand('ToggleToolbarDrawer', false, { skipFocus: true });
+
+// New approach (recommended)
+editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true });
 ----
 
 **Migration checklist:**
 
 * [ ] Locate all instances of `ToggleToolbarDrawer` command usage
-* [ ] Replace `skip_focus` with `skipFocus` in command options
+* [ ] Replace `skipFocus` with `skip_focus` in command options
 * [ ] Update any custom plugins using this command
 * [ ] Test toolbar drawer behavior after changes
 
@@ -441,6 +414,11 @@ The `template` plugin was removed in TinyMCE 7.0. If you were using this plugin,
 
 === Image Tools Plugin Removal
 
+[NOTE]
+====
+This section applies only if you're upgrading from TinyMCE 5 or earlier. The `imagetools` plugin was removed in TinyMCE 6.0, so if you're migrating from TinyMCE 6, this plugin was already unavailable.
+====
+
 The `imagetools` plugin was removed in TinyMCE 6.0. If you were using this plugin, you need to migrate to the premium Enhanced Image Editing feature.
 
 **Migration Steps:**
@@ -477,6 +455,11 @@ tinymce.init({
 
 === Text Color Plugin Removal
 
+[NOTE]
+====
+This section applies only if you're upgrading from TinyMCE 5 or earlier. The `textcolor` plugin was removed in TinyMCE 6.0, so if you're migrating from TinyMCE 6, this plugin was already unavailable.
+====
+
 The `textcolor` plugin was removed in TinyMCE 6.0. If you were using this plugin, you need to migrate to the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality.
 
 **Migration checklist:**

modules/ROOT/pages/migration-from-7x.adoc

@@ -336,7 +336,7 @@ editor.execCommand('ToggleToolbarDrawer', false, null, { skip_focus: true })
 
 
 * [ ] Locate all instances of `ToggleToolbarDrawer` command usage
-* [ ] Replace `skip_focus` with `skipFocus` in command options
+* [ ] Replace `skipFocus` with `skip_focus` in command options
 * [ ] Update any custom plugins using this command
 * [ ] Test toolbar drawer behavior after changes
 
@@ -358,17 +358,17 @@ The undocumented `editor.documentBaseUrl` property has been removed.
 console.log('documentBaseUrl', editor.documentBaseUrl);
 
 // Use this instead
-console.log('documentBaseURI', editor.documentBaseURI.getURI());
+console.log('documentBaseURI', editor.editorManager.documentBaseURI.getURI());
 ----
 
-TIP: Use `editor.documentBaseURI.getURI()` for all base URL operations.
+TIP: Use `editor.editorManager.documentBaseURI.getURI()` for all base URL operations.
 
 **Impact**: This change improves URL handling consistency by removing an undocumented API that was not aligned with the documented `documentBaseURI` property.
 
 **Migration steps:**
 
 
-To update all references of `documentBaseUrl` to the new API, replace any usage of `editor.documentBaseUrl` (or similar) with `editor.documentBaseURI.getURI()`. The property `documentBaseUrl` has been removed, and the correct way to access the document base URL is now through the `documentBaseURI` property, which is a URI object. You can then call `.getURI()` on it to get the string value of the URL.
+To update all references of `documentBaseUrl` to the new API, replace any usage of `editor.documentBaseUrl` (or similar) with `editor.editorManager.documentBaseURI.getURI()`. The property `documentBaseUrl` has been removed, and the correct way to access the document base URL is now through the `editorManager.documentBaseURI` property, which is a URI object. You can then call `.getURI()` on it to get the string value of the URL.
 
 .For example, update this:
 [source, js]
@@ -380,7 +380,7 @@ to:
 
 [source, js]
 ----
-const baseUrl = tinymce.activeEditor.documentBaseURI.getURI();
+const baseUrl = tinymce.activeEditor.editorManager.documentBaseURI.getURI();
 ----
 
 This change is necessary because the undocumented `editor.documentBaseUrl` API has been removed to improve URL handling consistency. The new approach uses the documented `documentBaseURI` property, which provides a URI object with methods such as `getURI()` to retrieve the full URL string. 
@@ -391,7 +391,7 @@ For more information see: link:https://www.tiny.cloud/docs/tinymce/latest/apis/t
 
 
 * [ ] Search your codebase for all instances of `editor.documentBaseUrl`.
-* [ ] Replace them with `tinymce.activeEditor.documentBaseURI.getURI()` (or `editor.documentBaseURI.getURI()` if you have an `editor` reference).
+* [ ] Replace them with `tinymce.activeEditor.editorManager.documentBaseURI.getURI()` (or `editor.editorManager.documentBaseURI.getURI()` if you have an `editor` reference).
 
 '''