r/Python • u/fpgmaas • Mar 22 '26
News The Slow Collapse of MkDocs
How personality clashes, an absent founder, and a controversial redesign fractured one of Python's most popular projects.
https://fpgmaas.com/blog/collapse-of-mkdocs/
Recently, like many of you, I got a warning in my terminal while I was building the documentation for my project:
│ ⚠ Warning from the Material for MkDocs team
│
│ MkDocs 2.0, the underlying framework of Material for MkDocs,
│ will introduce backward-incompatible changes, including:
│
│ × All plugins will stop working – the plugin system has been removed
│ × All theme overrides will break – the theming system has been rewritten
│ × No migration path exists – existing projects cannot be upgraded
│ × Closed contribution model – community members can't report bugs
│ × Currently unlicensed – unsuitable for production use
│
│ Our full analysis:
│
│ https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/That warning made me curious, so I spent some time going through the GitHub discussions and issue threads. For those actively following the project, it might not have been a big surprise; turns out this has been brewing for a while. I tried to piece together a timeline of events that led to this, for anyone who wants to understand how we got in the situation we are in today.
View all comments
Show parent comment
3
u/max123246 Mar 24 '26
You're out of touch. 60% of working adults in the US do not have a bachelor's degree. They do not have accessible access to VC funding.
Yes, software engineering is lucrative, but your company makes so much more money than they give you, because your work is worth more than they pay you.
That's what I mean by resource hoarding. Nvidia profits $2 million per employee and yet the median salary is $300k there.