Our Continuation of MkDocs

(github.com)

21 points | by serhack_ 2 hours ago ago

10 comments

  • athorax 27 minutes ago

    Zensical has been a solid replacement for us so far. In general everything "just works" out of the box and is way quicker to build/reload. It is still in fairly early stages, but is actively being worked on https://zensical.org/spark/proposals/zap-005-navigation-auth...

    I hope they are able to monetize in a way the keeps the core project open while making it a sustainable venture going forward.

    • Tzk 23 minutes ago

      +1 for zensical. If you used (mostly) vanilla „material for mkdocs“, then zensical is a great replacement. I’ve also made the switch on personal projects and zensical works great in its current state.

    • Ancapistani 24 minutes ago

      Yep. I switched over to Zensical shortly after it was released.

  • kstrauser an hour ago

    Two open source dramas in one week? Get the popcorn. From one of the links[0]:

    > I do not see him as qualified to keep this project maintainership and if I had the choice, would I remove him.

    …where “him” is Tom Christie, aka lovelydinosaur, the original author from what I can tell, and the copyright holder from the license file.

    I don’t know what’s going on, but if someone contributing to one of my projects, that I wrote, started a public conversation about how to remove me, my public response might appear as that person disappearing from the project.

    Sure, feel free to follow the license and fork the project. Make it clear that it’s a fork, though. It feels misleading to describe it as a continuation of the existing project.

    [0] https://github.com/mkdocs/mkdocs/discussions/4088

  • kylebarron an hour ago

    See recent discussion in [0]

    [0]: https://news.ycombinator.com/item?id=47482185

    • pbronez an hour ago

      Yeah that’s a better link for the overall situation. Personally I’m betting on Zensical.

      • jf___ an hour ago

        Good to point out -- Zensical is the project by MkDocs author to supersedes the latter.

        • antx 26 minutes ago

          Correction, by the author or Material for MkDocs, Martin Donath AKA Squidfunk.

  • yuppiepuppie an hour ago

    Did something change? cause this was published back in March.

  • esafak an hour ago

    This is a timely discussion for me. I've been dealing with several open source packages that aren't moving nearly as fast I need to get work done. I fork them, creating feature branches to upstream and merge them into a vendored dev branch I can use myself. But when I can push a dozen PRs a day and the maintainers barely merge a few a month, the math does not add up. I bet many AI-powered developers are facing this problem. I tested the waters with some PRs and regretfully came to the conclusion that I have to work on my fork.

    Also, this MkDocs maintainer sounds crazy. Nobody is discouraging women from contributing.