Conversation
…passes
Three internal plan/spec docs contained literal text that mkdocs-macros
(Jinja2) parsed as template syntax, aborting `mkdocs build --strict`:
- plans/2026-06-14-hardening-p1-plan.md: JSDoc `@returns {{ok: ...}}` read
as a `{{` expression (Macro Syntax Error).
- specs/SPEC-2026-02-23-insights-driven-enhancements.md: GitHub Actions
`${{ github.event... }}` read as expression -> 'github' is undefined.
- specs/PLAN-2026-06-15-skill-cso-descriptions.md: bash `${#d}` read as a
`{#` comment open -> Missing end of comment tag.
Each offending code block is now wrapped in `{% raw %}...{% endraw %}`
(tags outside the fences with blank-line buffers to satisfy MD031). The
legitimate `{{ scholar.skill_count }}` macro in the cso-descriptions doc
is left outside the raw span so it still renders. `mkdocs build --strict`
now exits 0 with zero warnings; user-facing guides and version macros
untouched.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
target/milestone/next reflect v3.1.0 on main (tagged, Homebrew + Pages live); new last_session entry for the release. Maintenance mode. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The release published 2026-06-21; aligns mkdocs release_date macro, CHANGELOG
[3.1.0], WHATS-NEW-v3.1.0, and REFCARD 'Last Updated' to it (index.md renders
the date via the {{ scholar.release_date }} macro). Reaches main next release.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Docs/maintenance patch over v3.1.0 — no plugin code change (SCHOLAR_VERSION
constant follows the bump). Carries: actual ship-date correction (2026-06-21),
the {% raw %} fix for mkdocs --strict, and the .STATUS shipped-state update
already on dev. Counts unchanged (111 suites / 3,287 total / 131 node:test).
version-sync propagated; --gate 0 errors; mkdocs prev_version → 3.1.0.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
1 participant
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.
Scholar v3.1.1 — docs/maintenance patch
A docs/maintenance patch over v3.1.0. No plugin code changed — the skill, commands, and tests are byte-identical to v3.1.0; this exists to land the doc corrections on
main+ the live site under a clean version.Fixed
{{ }}/${{ }}in internal plan/spec docs in{% raw %}somkdocs build --strictpasses (the macros plugin no longer tries to evaluate them).Unchanged
/scholar:hub, 1 skill (statistical-pedagogy-framework).Test plan
dev(Run Test Suite, Validate Plugin Structure, Validate JSON Schemas, Dependency Audit)version-sync --gate: 0 errors · markdownlint: 0 ·mkdocs build --strict: 0 warningsFull changelog: https://github.com/Data-Wise/scholar/blob/v3.1.1/CHANGELOG.md
🤖 Generated with Claude Code