The Slow Collapse of MkDocs

(fpgmaas.com)

58 points | by zdw 3 days ago ago

12 comments

  • localuser13 3 days ago 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 3 days ago 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.

    • undefined 3 days ago ago
      [deleted]
  • digital_voodoo 8 hours ago ago

    As a non-technical person (not a dev, not a SWE, just a curious and selftaught tinkerer), I only want my _local_ markdown files to render as a beautiful - or at least, clean - webpage, to ease reading and sharing. No Github involved, no contorsionism needed. Just local md files. It should not be that complicated, at least that's what I felt.

    Those were the only requirements that made me settle with Material MkDocs, and that are driving me towards the fork MaterialX. The comparison the latter makes with Zensical [0] is _exactly_ how I feel it (again, as a non-technical person).

    [0] https://github.com/jaywhj/mkdocs-materialx#differences-from-...

    • squidfunk 5 hours ago ago

      Creator of Zensical here! Would you mind sharing a bit more detail on why you feel the comparison is on point? One of our core goals with Zensical is to simplify things – not add complexity. We’re also working toward making it an almost 100% drop-in replacement for Material and the broader MkDocs ecosystem, so I’d be especially interested in understanding what feels more complicated from your perspective. I’d appreciate any specifics on where we can improve.

      That said, I do think the linked comparison may be a bit misleading. As far as I can tell, MaterialX is still largely based on the Material for MkDocs codebase with mostly some UI changes, several of which the author has taken from Zensical.

  • galkk 3 days ago ago

    Is there anybody in this story who ends up appearing as not a complete nutjob?

  • Txmm 3 days ago 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.

  • Muhammad523 4 hours ago ago

    Imagine if oprypin is actually the original developer's sockpuppet account...