Skip to content

TINYDOC-3616: Remove the committed LLM attachments and the dead generator. - #4364

Merged
kemister85 merged 1 commit into
tinymce/8from
hotfix/8/TINYDOC-3616
Sep 28, 2026
Merged

kemister85 merged 1 commit into
tinymce/8from
hotfix/8/TINYDOC-3616

Conversation

@kemister85

@kemister85 kemister85 commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Ticket: TINYDOC-3616

Site: Staging branch

Changes:

  • Deleted modules/ROOT/attachments/llms.txt and llms-full.txt. The deploy on main now generates both files on every build (TINYDOC-3613), and the committed copies had already drifted from what the site serves.
  • Deleted the unused -scripts/generate-llm-files.js, generate-llm-files.sh and README-llm-files.md, and the two generate-llm-files* entries in package.json that pointed at them. The generator and its documentation live on main.
  • ai-coding-agents.adoc: llms-full.txt now contains the full content of every page, not an index of URLs, so its description in the table is updated to match.

How to test locally:

Run these from your tinymce-docs checkout. They do not depend on folder names.

This branch alone (about a minute, plus the install):

git fetch origin && git switch hotfix/8/TINYDOC-3616
yarn install --frozen-lockfile
npx antora ./antora-playbook-local.yml
npx http-server build/site -p 4000
  • The build prints no warnings.
  • ls build/site/tinymce/latest/_attachments/ lists only tinymceai-mcp-demo and url-dialog-demo, with no llms*.txt.
  • http://localhost:4000/tinymce/latest/ai-coding-agents/#llms-txt-files describes llms-full.txt as the full content of every page.
  • git grep -nE "generate-llm-files|README-llm-files|attachments/llms" returns nothing.

The deploy steps with this branch's content (about 5 minutes; stop the server first). This shows the build no longer needs the committed files:

export DOCS=$(pwd)
git worktree add ../docs-main-3616 origin/main && cd ../docs-main-3616 && yarn install --frozen-lockfile
perl -pe 's#branches: \[ tinymce/5, tinymce/6, tinymce/7, tinymce/8 \]#branches: [ tinymce/5, tinymce/6, tinymce/7 ]\n  - url: $ENV{DOCS}\n    branches: hotfix/8/TINYDOC-3616#' antora-playbook.yml > playbook-test.yml
yarn antora ./playbook-test.yml && yarn build:markdown build/site && yarn generate-llm-files build/site
ls -l build/site/llms.txt build/site/llms-full.txt
cmp build/site/llms.txt build/site/tinymce/latest/_attachments/llms.txt && cmp build/site/llms-full.txt build/site/tinymce/latest/_attachments/llms-full.txt && echo identical
  • llms-full.txt is about 3.9 MB.
  • The last command prints identical.

The ERROR lines during the Antora step come from the archived tinymce/5 content and appear on main too. Clean up afterwards with cd "$DOCS" && git worktree remove --force ../docs-main-3616.

These steps were run as written on fresh clones on 2026-09-28, and every check passed.


Pre-checks:

  • Branch is correctly prefixed:
  • Files removed have been deleted, not just excluded from the build (if applicable).
  • Build passes without console errors, warnings, or issues.

Review:

  • Documentation Team Lead has reviewed.

@kemister85
kemister85 merged commit 565fecb into tinymce/8 Sep 28, 2026
6 checks passed
@kemister85
kemister85 deleted the hotfix/8/TINYDOC-3616 branch September 28, 2026 03:56
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.

3 participants