Skip to content

Take the setup snippets' versions from antora.yml attributes - #4195

Merged
bbatsov merged 1 commit into
masterfrom
docs-version-attributes
Sep 12, 2026
Merged

bbatsov merged 1 commit into
masterfrom
docs-version-attributes

Conversation

@bbatsov

@bbatsov bbatsov commented Sep 12, 2026

Copy link
Copy Markdown
Member

The manual pinned cider-nrepl 0.59.0 in nine snippets while CIDER injects 0.62.2, piggieback was two releases behind, and troubleshooting still asked for Clojure 1.7. The versions are now component attributes in doc/antora.yml with a comment on where they come from, and the snippets reference them. Verified with a local site build that every reference is substituted.

Every manual snippet that pins cider-nrepl said 0.59.0 while CIDER has
been injecting 0.62.2, the piggieback pins were two releases behind, and
the troubleshooting page still asked for Clojure 1.7 when CIDER requires
1.10. Define the versions once as component attributes and reference them
from the snippets, so a release bumps one file instead of hunting through
nine pages. The indented literal paragraph in up_and_running and the
Markdown-style fence in the shadow-cljs page become proper source blocks,
since attribute substitution needs subs="attributes+" on the block.
@bbatsov
bbatsov merged commit 9785956 into master Sep 12, 2026
17 checks passed
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.

1 participant