The Slow Collapse of MkDocs
46 points by zdw 2 days ago | 6 comments
  • localuser13 2 days ago |
    A very surprising development indeed.

    The original author (who is also the leading maintainer of httpx, another huge package) started a crusade against male-dominated spaces such as... Github issues and discussions.

    >So… sharing the source isn’t the problem here. The issue is the GitHub working environment. I’m not interested in the smokey boys-only-club atmosphere, it feels starkly unprofessional.

    >We’re not having any more conversation in all-male online spaces. Not happening.

    It looks like 3 weeks ago a similar change happened in httpx - github discussions were disabled. https://github.com/encode/httpx/discussions/3784

    >I don't want to continue allowing an online environment with such an absurdly skewed gender representation. I find it intensely unwelcoming, and it's not reflective of the type of working environments I value.

    As a mkdocs user and a httpx user I find that concerning - I hope personal issues won't harm those projects long term (well it looks like mkdocs is already dead).

    • aorth a day ago |
      I'm not an MkDocs user yet but I've been meaning to be for years! It's unfortunate to hear about the issues with project leadership. Why bring the drama about gender into this?! It should be closed as off topic.
  • galkk a day ago |
    Is there anybody in this story who ends up appearing as not a complete nutjob?
  • Txmm a day ago |
    What are the best alternatives around? Not super keen to get locked into anything - don’t need crazy features. I’ll just set an agent migrating.
    • josiahpeters a day ago |
      Of course, we just adopted Material for MK Docs about 12 months ago.

      I’ve been looking at Zensical https://zensical.org/ as a replacement, but I couldn’t fully reason why they went off and did their own thing. I wasn’t sure if it was a money grab or what their motivation was.

      This article provided the context I needed to understand the why. We’re going to definitely give them a shot.

    • pax a day ago |
      I made a list [1] some time ago: Docusaurus has the most stars

      [1] https://docs.google.com/spreadsheets/d/18Riw9yTx6Scix3xv0wiV...