Fix AsciiDoc build warnings and broken cross-references#4290
Open
kemister85 wants to merge 1 commit into
Open
Conversation
- 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.
MitchC1999
approved these changes
Jul 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ticket: N/A — documentation build hygiene (no associated ticket)
Site: Staging branch
Changes:
Resolves all Antora/Asciidoctor build warnings on the
tinymce/8line (26 → 0) and repairs a set of broken cross-references. Verified with a full build: 0 errors, 0 warnings.{version},{serverName},{AI_SERVICE_URL}; the trial placeholder{apiKey}; and the Handlebars example{{FooBar}}..adocextension, 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
tinymceai-models.adoc→ Verifying limits —{version}in theGET /v1/models/{version}pathstinymceai-limits.adoc→ File limits —{version}tinymceai-chat.adoc→ Model selection —{version}tinymceai-api-quick-start.adoc→ Next steps —{version}tinymceai-jwt-authentication-intro.adoc→ Quick start —{apiKey}tinymceai-on-premises-mcp.adoc→ Proxy endpoints —{serverName}/{AI_SERVICE_URL}in the four proxy routes8.7.0-release-notes.adoc→ CSS custom property section —{{FooBar}}exampleHeading levels
tinymceai-cmds.adoc→ Toggling sidebars and Plugin commands — should nest correctly under TinyMCE AIRepaired cross-references
editor-command-identifiers.adoc→ Plugin Commands list — Export to PDF / Export to Word / Import from Word now jump to their sections; Enhanced Tables anchor renamedlicense-key.adoc→ Load error (Cloud) and Load error (Self-Hosted) — table links now resolvefull-featured-open-source-demo.adoc— "Full featured demo including Premium Plugins" link in the excluded-plugins table resolvessmart_paste.adoc→ in Copy and paste —powerpaste_autolink_urlsnote links topowerpaste-optionsnewdocument_content.adoc→ in Content behavior —editable_rootlink points tonon-editable-content-optionsPre-checks:
hotfix/8/docs-build-warningsmodules/ROOT/nav.adochas been updated (not applicable).