Repository navigation
Broken docs #1922
Description
Description
The docs now look like AI slop:
- confusing, I cannot find the settings
- wrong formatting
- wrong titles on the sidebar
Steps to reproduce
Navigate to this for example:
https://commitizen-tools.github.io/commitizen/config/version_provider/
Current behavior
Missing headers:
Wrong markdown usage:
version_provider is nowhere to be found in bump, it's isolated under:
https://commitizen-tools.github.io/commitizen/config/version_provider/
users cannto discover it
All the titles in bump page:
Desired behavior
Make it user friendly
Screenshots
No response
Environment
website
Activity
ttw225 commentedon Apr 3, 2026
Root cause: pygments==2.20.0 regressed HtmlFormatter so that when filename is None, it calls html.escape() on None and crashes with AttributeError: 'NoneType' object has no attribute 'replace'.
In our MkDocs stack, pymdownx.highlight ends up passing filename=None in the common case (no fence title), so the highlight step fails; pymdownx.superfences then doesn’t replace the fence, and the remaining text is parsed as normal Markdown — which is why ```bash and lines starting with # show up as plain text / headings.
Upstream:
Possible mitigation until a Pygments release with the fix is available: pin pygments<2.20 for the docs build (similar approach: jj-vcs/jj#9233).
woile commentedon Apr 3, 2026
Thanks, I'll try this out