Skip to content

fix(docs): bump mkdocs-material so pymdown-extensions 11 resolves - #672

Merged
deepeshrai-tech merged 1 commit into
mainfrom
fix/docs-pymdown-pin
Aug 14, 2026
Merged

deepeshrai-tech merged 1 commit into
mainfrom
fix/docs-pymdown-pin

Conversation

@amrit-agarwal-1

@amrit-agarwal-1 amrit-agarwal-1 commented Aug 14, 2026 •

Copy link
Copy Markdown
Contributor

What

Bumps mkdocs-material from 9.6.18 to 9.7.7 in docs/requirements.txt. One line; pymdown-extensions stays at 11.0.1.

Why

#650 bumped pymdown-extensions to 11.0.1, but mkdocs-material==9.6.18 declares:

Requires-Dist: pymdown-extensions~=10.2

~=10.2 means >=10.2,<11, so pip has two rules it cannot both satisfy and aborts before rendering anything:

ERROR: Cannot install -r docs/requirements.txt (line 13) and pymdown-extensions==11.0.1
because these package versions have conflicting dependencies.

The conflict is caused by:
    The user requested pymdown-extensions==11.0.1
    mkdocs-material 9.6.18 depends on pymdown-extensions~=10.2
ERROR: ResolutionImpossible

This breaks Docs PR Preview on every open PR, and main's own docs build — the Install docs requirements step never completes.

mkdocs-material 9.7.0 is the first release to relax the ceiling to pymdown-extensions>=10.2; 9.6.20, the last 9.6.x, still pins ~=10.2. So no patch-level bump escapes this — the only ways out are downgrading pymdown-extensions below 11 or moving mkdocs-material to >= 9.7.0.

@amrit-agarwal-1
amrit-agarwal-1 requested a review from a team August 14, 2026 05:14
@claude

claude Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

✅ No issues found. Checked for bugs and CLAUDE.md compliance.

@github-actions

github-actions Bot commented Aug 14, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-08-14 06:30 UTC

#650 bumped pymdown-extensions to 11.0.1, but mkdocs-material 9.6.18
declares pymdown-extensions~=10.2 (>=10.2,<11), so pip cannot satisfy
both and every docs build dies at install with ResolutionImpossible.

9.7.0 is the first mkdocs-material release to relax that to >=10.2.
Bumping to 9.7.7 keeps the 11.0.1 upgrade instead of reverting it.

Co-Authored-By: Claude Opus 5 <[email protected]>
@amrit-agarwal-1 amrit-agarwal-1 changed the title fix(docs): pin pymdown-extensions back below 11 fix(docs): bump mkdocs-material so pymdown-extensions 11 resolves Aug 14, 2026
@sonarqubecloud

Copy link
Copy Markdown

@deepeshrai-tech
deepeshrai-tech merged commit 797c7c0 into main Aug 14, 2026
23 of 25 checks passed
@deepeshrai-tech
deepeshrai-tech deleted the fix/docs-pymdown-pin branch August 14, 2026 06:30
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.

3 participants