Skip to content

fix(docs): Bump mkdocstrings to 1.0.8 to fix docs build - #2306

Merged
iMicknl merged 2 commits into
mainfrom
fix/docs-mkdocstrings-highlight
Oct 24, 2026
Merged

iMicknl merged 2 commits into
mainfrom
fix/docs-mkdocstrings-highlight

Conversation

@iMicknl

@iMicknl iMicknl commented Oct 24, 2026 •

Copy link
Copy Markdown
Owner

Why

The docs workflow has been failing since the pymdown-extensions 12.1 → 12.2 bump (#2291), on main (v2.2.3 release run) and on open PRs like #2304:

mkdocstrings/_internal/handlers/rendering.py:85, in Highlighter.__init__
TypeError: Highlight.__init__() missing 1 required positional argument: 'md'

pymdown-extensions 12.2 made md a required argument of pymdownx.highlight.Highlight.__init__. mkdocstrings 1.0.4 subclasses it without passing md.

What

  • Lockfile-only bump of mkdocstrings 1.0.4 → 1.0.8, which supports the new signature. pyproject.toml floors are unchanged.
  • Add uv.lock to the docs workflow pull_request paths, so lockfile-only bumps like build(deps): bump pymdown-extensions from 12.1 to 12.2 #2291 run the docs build (that is how this slipped through).

Testing

  • uv run mkdocs build succeeds (failed with the TypeError before).
  • prek run --all-files and pytest pass.

pymdown-extensions 12.2 made `md` a required argument of
`Highlight.__init__`, which mkdocstrings 1.0.4 does not pass, so
`mkdocs build` crashed rendering sdk-reference.md.
@iMicknl
iMicknl requested a review from tetienne as a code owner October 24, 2026 14:41
Copilot AI balanced review requested due to automatic review settings October 24, 2026 14:41

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request. Check if the Files changed in this pull request are included in default exclusions.

@github-actions github-actions Bot added the bug Something isn't working label Oct 24, 2026
Lockfile-only dependency bumps (e.g. #2291) could break the docs build
without CI noticing.
@iMicknl
iMicknl merged commit 433c267 into main Oct 24, 2026
15 checks passed
@iMicknl
iMicknl deleted the fix/docs-mkdocstrings-highlight branch October 24, 2026 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants