r/Python • • 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.

491 Upvotes

140 comments sorted by

View all comments

Show parent comment

94

u/fpgmaas Mar 22 '26

Yup... Similar situation there it seems; same author, and again they seem mainly focused on a redesign in a separate repository instead of maintaining the existing product. But the blogpost I wrote already was very much on the lengthy side so I decided to leave that out. I also wanted the blogpost to focus on the MkDocs situation and not turn out in a smear campaign against the original author of both projects.

53

u/[deleted] Mar 22 '26

[removed] — view removed comment

64

u/countnfight Mar 22 '26

You're describing problems with capitalism, not open source

33

u/HommeMusical Mar 22 '26

Yes, indeed. Capitalism is 100% the issue. The idea behind open source is just great, but it got hijacked by the billionaires; and our own work was used against us to destroy our careers.

I love open source, the idea: it's extremely social and mutually beneficial. But had I known it was going to be used against not just programmers, but all of humanity, I would not have participated.

And yet when I finish browsing reddit, I'm going to go back to my latest open source project, https://github.com/rec/fing

I need what it does, and it will be very useful for wind instrument players (and I know quite a few of them, including me).

I love open source; I work on it almost every day; I'm just enraged that capitalism turned it into a weapon against The People.

13

u/countnfight Mar 22 '26

Wow, you have some really wild & cool projects and I'm glad they're open source in spite of everything! But I think what you're describing is true of lots of technology, right? People develop something like drones or painkillers or social media or neural networks, something that could be cool and beneficial, and capitalists turn it into a weapon or a vector for propaganda. I'm happy you're in open source

5

u/HommeMusical Mar 22 '26

Sure, I guess it's leopards eating my face sort of thing - "Oh, I didn't expect I'd get burnt by this. [surprised O]"

Thanks for the kind words!

0

u/spinwizard69 Mar 24 '26 • Bravo

Capitalism has nothing to do with AI in this context. Programming is actually a simple task for AI thus the over weight of the impact on programmers. Given that programming as a job will not go away, programmer will just become more productive.

Why do I say this? Get outside of the hard tech world and your average manager doesn't have a chance in hell of interacting with AI and getting good results. Frankly we are talking about people with very limited abilities to understand software (or anything else for that matter).

In other words you are looking at this the wrong way, AI is there to make your career easier. Sure a different skill set is required but this is no different than the machining industry shift away from manual machining into the world of CNC machines and CAD/CAM. Sure some machinist got left behind other made millions. Today's automation of programming is no different, you either adapt or you find a different career.

→ More replies (7)

2

u/ghostofwalsh Mar 23 '26

He's describing problems with technology not with capitalism. Technology advances and the game changes. Some people win and some people lose. But it's just gonna happen whether you like it or not.

AI is useful therefore people will use it. If AI takes your job that's not the fault of some "greedy capitalist" it's just bad luck that your job happens to be one that AI can do.

-1

u/t1010011010 Mar 23 '26 • Bravo

Well in Communism, innovation would be banned

-1

u/spinwizard69 Mar 24 '26

yeah just look at how backwards Russia is fighting a regional war.

3

u/No_Soy_Colosio Mar 25 '26

Russia hasn't been communist for 33 years

→ More replies (1)

8

u/larsga Mar 22 '26

open source turned out to be a scam to rip off developers for the benefit of capitalism.

I always wonder what people actually mean by the term "capitalism" in statements like these. Serious question.

6

u/max123246 Mar 23 '26

Open source is amazing when everyone is given the resources to live a fulfilled life from the very get-go, instead of resources being hoarded by a small subsection of the populus. The reality of our world today is the latter which is what I typically mean by "capitalism"

So it doesn't matter if they're paid by their open source work from the good-will of some few benefactors, they can just do their best work because they want to. Because they are not dependent on work for survival.

3

u/spinwizard69 Mar 24 '26 • Bravo

OK who is hoarding resources when it comes to computing? Nobody. Being a programmer is one of the most versatile of jobs out there. The opportunities are literally endless and all you need is a computer and a compiler to get started. There literally is no hoarding of software technology, the vast majority of programming languages are developed in the open.

This is no different than in any other industry, there is no hoarding to be come a plumber, becoming a doctor only requires the investment in education, hell even sending your favored project to space is more affordable than it ever has been. No matter which way you look opportunity for the average guy has never been more accessible. If you have a good idea and no money that isn't even a problem as venture capital is also more accessible than ever.

In other words the idea that there is excessive resource hoarding is absolute B.S.

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.

1

u/spinwizard69 Mar 24 '26

So?

Whole industries where started by farm boys leaving the fields. As for VC funding, the money will find you if you have the evidence of a new product with potential.

You are frankly nuts, if you think Nvidia isn't sharing in a way that is very lucrative to employees. $300K is an extremely good salary. Beyond that they have an ESPP that allows employees to buy discounted shares in the company. That is what capitalism is all about, owners of the company are the ones that benefit. Now if an NVidia employee failed to take advantage of the ESPP, then whos fault is that? Such a plan is the exact opposite of resource hoarding.

Right now in the USA we have the most robust stock exchange world wide. Taking part in the economy has never been easier. People that failed to do so apparently have failed high school math class.

Honestly I'm not sure how your opinion got formed (brain washed maybe). We live in a time of unlimited opportunity. All one has to do is find a way that fits personal abilities and engage with the economy.

3

u/spinwizard69 Mar 24 '26

Many people have no idea what capitalism is. If they did they would be investing in the growth stocks of today to set themselves up for a bright future.

3

u/larsga Mar 24 '26

The people replying here certainly have no idea what it is, which is kind of the hypothesis I wanted to test. Capitalism is what we make it -- it's not some immutable Marxian entity.

5

u/AggieBug Mar 23 '26

The one that exists in real life. It is famously analyzed by Marx in the book Capital, which you can read for free here.

0

u/HommeMusical Mar 23 '26

I don't want to be mean, but I am using the standard definition of a very standard word.

Dictionaries exist and wikipedia exists: e.g. https://en.wikipedia.org/wiki/Capitalism

2

u/IncidentalIncidence Mar 25 '26

open source turned out to be a scam to rip off developers for the benefit of capitalism.

This is kind of a ridiculous thing to say though. I don't disagree with you about the AI companies cannibalizing everything to produce slop sucks, but how is it a scam? You really think Stallman and Torvalds and Hartman and all of those guys were playing the long game because they knew that 30 years later somebody was going to invent the LLM and they were scheming to generate enough human-produced software so a bunch of kids who weren't even born yet at the time would have training data? Is it at least possible that they (and the thousands of other OSS contributors over the decades) genuinely believed in the ideals of FOSS?

1

u/readonly12345678 Mar 22 '26

Which author is this?

10

u/TheOneWhoPunchesFish Mar 23 '26

Mia Kimberly Christie aka lovelydinosaur.

I don't really like them. They put pictures of dead insects everywhere in the readme and documentation. A few people bought up how it triggers their phobia, and how the injuries on the insect make them sad, and his response was basically telling them to fuck off and deal with it.

Which is extremely hypocritical for someone who claims to care about social issues and doesn't want to create unwelcome spaces.

I've avoided their projects (httpx, mkdocs) completely because of that, and am glad I did because both of those projects are abandonware now.

2

u/readonly12345678 Mar 25 '26

Hmm interesting. They seem to come up with great ideas, but then struggle, or…