Skip to content

Fix AsciiDoc build warnings and broken cross-references#4290

Open
kemister85 wants to merge 1 commit into
tinymce/8from
hotfix/8/docs-build-warnings
Open

Fix AsciiDoc build warnings and broken cross-references#4290
kemister85 wants to merge 1 commit into
tinymce/8from
hotfix/8/docs-build-warnings

Conversation

@kemister85

@kemister85 kemister85 commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Ticket: N/A — documentation build hygiene (no associated ticket)

Site: Staging branch

Changes:

Resolves all Antora/Asciidoctor build warnings on the tinymce/8 line (26 → 0) and repairs a set of broken cross-references. Verified with a full build: 0 errors, 0 warnings.

  • Escaped literal curly-brace tokens that were being parsed as attribute references (and dropped from output): REST/MCP path parameters {version}, {serverName}, {AI_SERVICE_URL}; the trial placeholder {apiKey}; and the Handlebars example {{FooBar}}.
  • Corrected heading levels in the TinyMCE AI commands partial (sections were one level too deep under "TinyMCE AI").
  • Repaired broken cross-references — mismatched anchor ids, a missing .adoc extension, and wrong target pages in shared partials.

Visual review — staging deep links

Each link opens the changed section on the staging preview (available once the preview build finishes). Escaped tokens should now render literally (for example GET /v1/models/{version}); repaired links should resolve to a real target.

Curly-brace escapes

Heading levels

Repaired cross-references

Pre-checks:

  • Branch is correctly prefixed: hotfix/8/docs-build-warnings
  • Build passes without console errors, warnings, or issues.
  • modules/ROOT/nav.adoc has been updated (not applicable).
  • Files added for new product features include a release note entry (not applicable).

- Escape literal curly-brace tokens ({version}, {apiKey}, {serverName},
  {AI_SERVICE_URL}, {{FooBar}}) that were parsed as attribute references.
- Correct heading levels in the TinyMCE AI commands partial.
- Repair broken cross-references: missing .adoc extension, wrong target
  page/anchor, and section anchor ids that did not match their sections.
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.

2 participants