From 34ce4313a44ea424fd9a549a70aea9a6923bcb89 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 18 Jun 2025 09:08:07 +1000 Subject: [PATCH 1/5] DOC-3234: Create an index page for all TinyMCE upgrade guides. --- modules/ROOT/nav.adoc | 16 ++++++--- modules/ROOT/pages/migration-from-5x.adoc | 2 +- modules/ROOT/pages/migration-from-6x.adoc | 2 +- modules/ROOT/pages/migration-guide.adoc | 41 +++++++++++++++++++++++ 4 files changed, 54 insertions(+), 7 deletions(-) create mode 100644 modules/ROOT/pages/migration-guide.adoc diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index d7d1195f50..54413c0522 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -53,7 +53,12 @@ **** xref:dotnet-projects.adoc[.NET projects] **** xref:bower-projects.adoc[Bower projects] **** xref:zip-install.adoc[{productname} .zip deployments] -** xref:upgrading.adoc[Upgrading {productname}] +// ** xref:migration-guide.adoc[Migration guides] +// *** xref:migration-from-6x.adoc[Migrating from TinyMCE 6] +// *** xref:migration-from-5x.adoc[Migrating from TinyMCE 5] +// *** xref:migration-from-4x.adoc[Migrating from TinyMCE 4] +// *** xref:migration-from-froala.adoc[Migrating from Froala] +// *** xref:upgrading.adoc[General upgrade information] * xref:how-to-guides.adoc[How-to guides] ** Learn the basics *** xref:basic-setup.adoc[Basic setup] @@ -209,10 +214,11 @@ **** xref:bundling-localization.adoc[UI localizations] **** xref:bundling-themes.adoc[Themes] ** xref:upgrading.adoc[Upgrading {productname}] -** xref:migration-from-4x.adoc[Migrating from {productname} 4] -** xref:migration-from-5x.adoc[Migrating from {productname} 5] -** xref:migration-from-6x.adoc[Migrating from {productname} 6] -** xref:migration-from-froala.adoc[Migrating from Froala] +** xref:migration-guide.adoc[Migration guides] +*** xref:migration-from-4x.adoc[Migrating from {productname} 4] +*** xref:migration-from-5x.adoc[Migrating from {productname} 5] +*** xref:migration-from-6x.adoc[Migrating from {productname} 6] +*** xref:migration-from-froala.adoc[Migrating from Froala] ** xref:generate-rsa-key-pairs.adoc[Generate public key pairs] ** xref:understanding-editor-loads.adoc[Understanding editor loads] * xref:examples.adoc[Examples] diff --git a/modules/ROOT/pages/migration-from-5x.adoc b/modules/ROOT/pages/migration-from-5x.adoc index 9e8d68add6..6ccbed6713 100644 --- a/modules/ROOT/pages/migration-from-5x.adoc +++ b/modules/ROOT/pages/migration-from-5x.adoc @@ -1,4 +1,4 @@ -= Migrating from {productname} 5 to {productname} 7 += Migrating from {productname} 5 to {productname} {release-version} :navtitle: Migrating from TinyMCE 5 :description: Guidance for migrating from TinyMCE 5 to TinyMCE 7 :keywords: migration, considerations, premigration, pre-migration diff --git a/modules/ROOT/pages/migration-from-6x.adoc b/modules/ROOT/pages/migration-from-6x.adoc index f28052f085..3ba9531ac5 100644 --- a/modules/ROOT/pages/migration-from-6x.adoc +++ b/modules/ROOT/pages/migration-from-6x.adoc @@ -1,4 +1,4 @@ -= Migrating from {productname} 6 to {productname} 7 += Migrating from {productname} 6 to {productname} {release-version} :navtitle: Migrating from TinyMCE 6 :description: Guidance for migrating from TinyMCE 6 to TinyMCE 7 :keywords: migration, considerations, premigration, pre-migration diff --git a/modules/ROOT/pages/migration-guide.adoc b/modules/ROOT/pages/migration-guide.adoc new file mode 100644 index 0000000000..3e54b3a1e0 --- /dev/null +++ b/modules/ROOT/pages/migration-guide.adoc @@ -0,0 +1,41 @@ += TinyMCE Migration Guides +:description: Comprehensive guides for upgrading between TinyMCE versions (4.x, 5.x, 6.x) and migrating from other rich text editors +:keywords: migration, upgrade, version, tinymce 4, tinymce 5, tinymce 6, froala +:title_nav: Migration Guides +:toc: macro +:toclevels: 2 +:toc-title: Version Migration Guides +:toc-placement: preamble +:toc-type: flat + +[cols="1,1"] +|=== + +a| +[.lead] +xref:migration-from-6x.adoc[Migrating from TinyMCE 6] + +Guide for upgrading from TinyMCE 6 to TinyMCE 7, covering configuration changes and UI component updates. + +a| +[.lead] +xref:migration-from-5x.adoc[Migrating from TinyMCE 5] + +Guide for upgrading from TinyMCE 5 to TinyMCE 7, including architectural improvements and security updates. + +a| +[.lead] +xref:migration-from-4x.adoc[Migrating from TinyMCE 4] + +Guide for upgrading from TinyMCE 4 to TinyMCE 7, detailing major architectural changes and modern UI improvements. + +a| +[.lead] +xref:migration-from-froala.adoc[Migrating from Froala] + +Guide for migrating from Froala Editor to TinyMCE, with equivalent feature mappings and configuration guidance. + +// Empty cell to even out rows +a| + +|=== \ No newline at end of file From 4cdee26ac815969ac42946fab8e1a85871d072e5 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 18 Jun 2025 09:21:46 +1000 Subject: [PATCH 2/5] DOC-3234: fix nesting issue. --- modules/ROOT/nav.adoc | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 54413c0522..3369353f86 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -53,12 +53,7 @@ **** xref:dotnet-projects.adoc[.NET projects] **** xref:bower-projects.adoc[Bower projects] **** xref:zip-install.adoc[{productname} .zip deployments] -// ** xref:migration-guide.adoc[Migration guides] -// *** xref:migration-from-6x.adoc[Migrating from TinyMCE 6] -// *** xref:migration-from-5x.adoc[Migrating from TinyMCE 5] -// *** xref:migration-from-4x.adoc[Migrating from TinyMCE 4] -// *** xref:migration-from-froala.adoc[Migrating from Froala] -// *** xref:upgrading.adoc[General upgrade information] +*** xref:upgrading.adoc[General upgrade information] * xref:how-to-guides.adoc[How-to guides] ** Learn the basics *** xref:basic-setup.adoc[Basic setup] From 6cfd3acc1440adcb9d800a2b94cc8ccde07f8c5b Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 18 Jun 2025 09:24:42 +1000 Subject: [PATCH 3/5] DOC-3234: remove incorrect placed upgrading link in nav.adoc. --- modules/ROOT/nav.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 3369353f86..2208c4e66f 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -53,7 +53,6 @@ **** xref:dotnet-projects.adoc[.NET projects] **** xref:bower-projects.adoc[Bower projects] **** xref:zip-install.adoc[{productname} .zip deployments] -*** xref:upgrading.adoc[General upgrade information] * xref:how-to-guides.adoc[How-to guides] ** Learn the basics *** xref:basic-setup.adoc[Basic setup] From a5dba5dfa427b7deb0d069fab400c0f7043a7dff Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 18 Jun 2025 09:55:56 +1000 Subject: [PATCH 4/5] DOC-3234: re-indroduce deleted nav link. --- modules/ROOT/nav.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 2208c4e66f..3369353f86 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -53,6 +53,7 @@ **** xref:dotnet-projects.adoc[.NET projects] **** xref:bower-projects.adoc[Bower projects] **** xref:zip-install.adoc[{productname} .zip deployments] +*** xref:upgrading.adoc[General upgrade information] * xref:how-to-guides.adoc[How-to guides] ** Learn the basics *** xref:basic-setup.adoc[Basic setup] From 9826bcadb56c612e1cb9837cc64790f8fcf2e3ab Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 18 Jun 2025 09:56:38 +1000 Subject: [PATCH 5/5] Update modules/ROOT/nav.adoc --- modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 3369353f86..59652bc6d3 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -53,7 +53,7 @@ **** xref:dotnet-projects.adoc[.NET projects] **** xref:bower-projects.adoc[Bower projects] **** xref:zip-install.adoc[{productname} .zip deployments] -*** xref:upgrading.adoc[General upgrade information] +** xref:upgrading.adoc[General upgrade information] * xref:how-to-guides.adoc[How-to guides] ** Learn the basics *** xref:basic-setup.adoc[Basic setup]