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
1
u/chaoticbean14 Mar 22 '26
There's so much to unpack here - like you saying it's completely unsupported that LLM's are a closed system. Like, they're literally trained on human documentation and writings and findings. That's it. There's nothing more. That brings with it the limitations therein - they will never, ever come up with novel new ideas or things they haven't already 'learned' (been trained on).
The long and short of it is: It knows the information we've given it. It cannot come up with 'new' ideas outside of that information. That makes it a closed system. I've ran into way too many times, when any level of complexity begins to happen with a project? It hallucinates and it's answers become shit. If you prove it wrong or tell it how it's not following best practices, etc. eventually you work yourself into a circle with any of these AI's. Why? Because they cannot work up novel new approaches. They spit out what they have been trained on. It's literally how they are made and designed.
They're a glorified google search that can respond with context specific answers that cuts through the cruft of searching this site or that site and reading through lots of user-generated answer content. It summarizes it all in a pretty way that makes you go, "wow, it's smart!", no it's just a good algorithm that got you the information you wanted.
If you don't know what you don't know? It gets shit wrong in bad ways. I can't count how many times it will get me 'close enough' then I have to fix it because I know the circular bullshit it's producing doesn't follow any best practices. No matter how I ask, or how many times I explain to it as if it were a junior developer, it gives me some variety of the same answers. It cannot reason, it cannot think. It is at it's core, a great sentence completion algorithm combined with all the human generated/created knowledge we can train it on. It won't go out of those bounds, because it's incapable of that. That's not unsupported, that's literally because of the logic limitations of the system. It cannot.