DOC-3356: New feature documentation for `tinymceai`. by kemister85 · Pull Request #3976 · tinymce/tinymce-docs

kemister85 · 2026-02-09T04:48:22Z

Ticket: DOC-3356

Revert reminder (temporary CI workaround)

Revert commit 8121a0f7b5925f1c7631ac82442fb3ab98e19234 — After DOC-3399 is resolved or a permanent fix is in place, revert this commit so .github/workflows/preview_create.yml returns to the previous trigger set. This commit adds workflow_dispatch (manual preview when automatic runs fail), plus pull_request types edited and ready_for_review. edited also runs on PR title and body edits, which can enqueue extra workflow runs.
Revert commit 20a10981fc27b1529071e7f81008c2b563cf3973 — Before merging this PR, revert this commit (or exclude it from the merge) so preview_create.yml is not changed on the target branch unless the team adopts the canonical redirects.json raw URL permanently. This commit switches the redirects input from .../refs/heads/main/redirects.json to .../main/redirects.json to unblock the docs preview workflow when the generate-redirects action cannot fetch the refs/heads URL.

Site: Staging branch

Changes:

TinyMCE AI documentation

TinyMCE AI Introduction – Refined intro, AI service Cloud-only callout, and On-Premises section with contact link
TinyMCE AI Overview
Chat
Review
Actions
API Overview
API Quick Start
Integration Options
JWT Authentication Intro
JWT with Node.js
JWT with PHP
Limits
Models
Permissions
Privacy
Streaming

Reference and configuration

Other affected pages

Pre-checks:

Branch is correctly prefixed: feature/8.4.0/DOC-3356
modules/ROOT/nav.adoc has been updated (if applicable).
Files have been included where required (if applicable).
Files removed have been deleted, not just excluded from the build (if applicable).
Files added for New product features include a release note entry.
Major or minor version changes have updated the supported-versions.adoc table.
Build passes without console errors, warnings, or issues.

Review:

Documentation Team Lead has reviewed.

modules/ROOT/partials/auth/tinymceai/nodejs/initial-project-setup.adoc

modules/ROOT/pages/tinymceai-with-jwt-authentication-nodejs.adoc

modules/ROOT/pages/tinymceai-chat.adoc

modules/ROOT/pages/tinymceai-review-plugin.adoc

modules/ROOT/pages/tinymceai-actions-plugin.adoc

modules/ROOT/pages/tinymceai-chat.adoc

modules/ROOT/pages/tinymceai.adoc

modules/ROOT/pages/tinymceai-integration.adoc

Co-authored-by: Millie <millie.macdonald@tiny.cloud>

modules/ROOT/pages/tinymceai-models.adoc

modules/ROOT/pages/tinymceai-chat.adoc

modules/ROOT/pages/tinymceai-jwt-authentication-intro.adoc

kemister85 · 2026-03-27T12:18:26Z

One thing I noticed is that because we sort premium plugins alphabetically, old AI plugin is 3rd on the list, but the new one is almost at the end.

I have reused the signup component to feature tinymceai at the top of the premium plugins list. See this commit

modules/ROOT/pages/tinymceai-api-quick-start.adoc

…fore styles Asciidoctor emitted a style-only pass block before the open block, unlike the signup banner partial. Use one passthrough with markup then style so layout matches other promo blocks.

Release-notes template placeholders like plugin<s> and improvement<s> were published as raw angle brackets. Browsers treated <s> as HTML, which broke sidebar markup site-wide. Correct 8.4.0 nav xrefs to #new-premium-plugins and #new-open-source-plugin; replace placeholder wording with final copy.

Remove admon-plugins-tinymce-ai-feature partial and include; restore TinyMCE AI as a table row and prior AI Assistant copy.

Restore partial with single passthrough (markup before inline styles). Include from premium-plugins; AI Assistant (legacy) row; no duplicate TinyMCE AI table row.

…table

…shot

… Actions framing

Reframe comparison around scope and UI; remove misleading suggestions vs transformations contrast. Rename section, deduplicate Actions API paragraph with cross-reference.

After keypair steps, point to full token endpoint implementations to match JWT Authentication quick setup.

- Order Supported Models like API items; drop gemini-3-pro (not listed) - Match GPT-5 Mini description to API; default model example uses claude-4-5-haiku

- Chat: clarify default model ids and link to models API; list context file types - Introduction: add Next steps section with links to setup and API docs

…Actions Describe default versus custom toolbar behavior, link quickbars_selection_toolbar, add Quickbars example, and remove redundant toolbar guide sentence.

The model selector can be used at any time during a conversation; a new chat is not required to switch models.

Describe Expand as collapsing or expanding modification history in the chat panel, not document suggestions. Move the explanation to Working with AI-generated changes.

Rename the first column to Editor, shorten the column intro bullets, and clarify system actions versus Chat without repeating the REST path.

Introduce stateless behavior and Chat handoff near the page opening; add a Quick Actions vs Review lead-in; dedupe the Actions API section and link to the stateless anchor.

DOC-3243: TinyMCE 8.4.0 Release Documentation and Community Changelog.

0e97c85

kemister85 added this to the TinyMCE 8.4.0 milestone Feb 9, 2026

kemister85 added the upcoming release Documentation for features currently under development/QA label Feb 9, 2026

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/partials/auth/tinymceai/nodejs/initial-project-setup.adoc Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-with-jwt-authentication-nodejs.adoc Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-chat.adoc Outdated Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-chat.adoc Outdated Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-chat.adoc Outdated Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-chat.adoc Outdated Show resolved Hide resolved

metricjs reviewed Feb 11, 2026

View reviewed changes

modules/ROOT/pages/tinymceai-chat.adoc Show resolved Hide resolved