Skip to content

fix: repair broken admonitions caused by Docusaurus 3.10.1 upgrade#798

Open
Juminstock wants to merge 2 commits into
mainfrom
fix/subsquare-guide-admonitions
Open

fix: repair broken admonitions caused by Docusaurus 3.10.1 upgrade#798
Juminstock wants to merge 2 commits into
mainfrom
fix/subsquare-guide-admonitions

Conversation

@Juminstock

Copy link
Copy Markdown
Contributor

Summary

The Docusaurus 3.10.1 upgrade (#793) pulled in a newer mdast-util-directive/micromark-extension-directive. It enforces the strict directive spec: admonition titles must use bracket syntax, :::info[Title]. The old freeform syntax :::info Title is no longer recognized as a directive at all, so it silently rendered as literal paragraph text instead of a styled callout (as reported by Guenael on the Subsquare governance guide).

  • Converted all freeform-title admonitions (:::type Title -> :::type[Title]) across the repo: 25 in subsquare_guide.md, 72 more across 18 other files.
  • Removed two unrelated orphaned closing ::: fences (pre-existing since 2022/2023, unrelated to the dependency bump) in binary.md and docker.md that were also rendering as stray literal text.

@github-actions

Copy link
Copy Markdown

Visit the preview URL for this PR (updated for commit 8856466):

https://astar-docs--pr798-fix-subsquare-guide-1b7c9ze1.web.app

(expires Sat, 01 Aug 2026 00:50:23 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: f2f13e9b593d211faae6343d67a88fac3fd7268d

@Juminstock Juminstock self-assigned this Jul 25, 2026
@Juminstock Juminstock added the documentation Improvements or additions to documentation label Jul 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant