Skip to content

Conversation

@kemister85
Copy link
Contributor

@kemister85 kemister85 commented Oct 20, 2025

Ticket: DOC-3305

Site: Migration Guides (main landing page)

Site: Migration 4 > 8
Site: Migration 5 > 8
Site: Migration 6 > 8

Changes:

  • Provide clear, actionable guidance for upgrading between TinyMCE versions (4.x, 5.x, 6.x, 7.x, 8.x).

Pre-checks:

  • Branch prefixed with feature/<version>/, hotfix/<version>/, staging/<version>/, or release/<version>/.

Review:

  • Documentation Team Lead has reviewed

@kemister85 kemister85 requested review from a team, TheSpyder, jscasca, metricjs and tiny-ben-tran and removed request for a team January 16, 2026 03:20
@kemister85 kemister85 marked this pull request as ready for review January 16, 2026 03:25
@kemister85 kemister85 requested review from a team and soritaheng as code owners January 16, 2026 03:25
Copy link
Contributor

@MitchC1999 MitchC1999 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work!

@kemister85
Copy link
Contributor Author

kemister85 commented Jan 30, 2026

Update based on last commit

Summary of Changes Made

Removed incorrect UI Themes and Skins section (6→8 guide)

  • Removed the "UI Themes and Skins" section from migration-from-6x-to-8x.adoc
  • Theme changes (modern/lightgray/mobile → silver/oxide) occurred in v5, not v6-8

Fixed theme migration instructions (5→7 guide)

  • Updated migration-from-5x.adoc to state that no theme changes are needed when migrating from v5 to v7
    v5 already uses the Silver theme with Oxide skin

Fixed incorrect code example (5→8 guide)

  • Replaced the wrong autocompleter example in the table_responsive_width section with the correct table configuration example

Clarified plugin removal sections (6→8 guide)

  • Added notes to imagetools and textcolor sections clarifying they were removed in v6.0
  • Added notes that these sections only apply when migrating from v5 or earlier
  1. Fixed reversed skipFocus/skip_focus examples (multiple guides)

Corrected examples in:

  • migration-from-6x-to-8x.adoc
  • migration-from-4x-to-8x.adoc
  • migration-from-5x-to-8x.adoc
  • Changed from showing skip_focus as old → skipFocus as new to showing skipFocus as deprecated → skip_focus as recommended

Fixed documentBaseUrl replacement API (all guides)

  • Updated all migration guides to use editor.editorManager.documentBaseURI.getURI() instead of editor.documentBaseURI.getURI()

Updated files:

  • migration-from-6x-to-8x.adoc
  • migration-from-7x.adoc
  • migration-from-4x-to-8x.adoc
  • migration-from-5x-to-8x.adoc

Additional Verification

  • Cross-referenced changes against official TinyMCE changelogs (v5, v6, v7, v8)

Copy link
Contributor

@ShiridiGandham ShiridiGandham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My view is that we should move this forward and then wait for feedback from customers. We’re ready to amend the content and apply hotfixes at any time if needed. So let’s proceed and release.

@kemister85 kemister85 merged commit 0b93fad into tinymce/8 Feb 2, 2026
5 checks passed
@kemister85 kemister85 deleted the hotfix/8/DOC-3305 branch February 2, 2026 00:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants