The Slow Collapse of MkDocs
This title could be clearer and more informative.Try out Clickbait Shieldfor free (5 uses left this month).
MkDocs, the Python documentation tool powering over 90,000 GitHub projects, is in a state of collapse driven by years of maintainer conflicts, an absent founder, and a controversial v2 redesign. The original author (@lovelydinosaur) returned after 8 years to pursue a plugin-incompatible MkDocs 2.0 rewrite in a private repo, alienating the community. A former maintainer (@oprypin) staged a PyPI takeover in protest, which was quickly reversed. The ecosystem has now fractured into three competing successors: ProperDocs (a drop-in MkDocs 1.x fork by @oprypin), MaterialX (a continuation of Material for MkDocs), and Zensical (a ground-up rewrite by the Material for MkDocs team, currently the most popular with 3,700+ stars). Material for MkDocs itself has entered maintenance mode. The story illustrates how personality clashes, governance failures, and unilateral decisions by an absent founder can fracture even a widely-adopted open source project.
Sort: