From a2a0fee72a25405d08f78680ed485aee4d168766 Mon Sep 17 00:00:00 2001 From: Vinta Chen Date: Sun, 23 Aug 2026 00:48:25 +0800 Subject: [PATCH] docs: replace mkdocs with zensical in Documentation section Material for MkDocs went into maintenance mode on 2025-11-05 and its own team called upstream mkdocs unmaintained since 2024-08 and a supply chain risk; the mkdocs repo was last pushed 2025-10-20. Since mkdocs-material hard-depends on mkdocs, mkdocs' download count is almost entirely mkdocs-material pulling it in (18,360,677/month vs mkdocs-material's 18,167,775/month, ~1% delta), so dropping the redundant direct entry costs little. zensical is a clean replacement with no mkdocs dependency, built by the same Material for MkDocs team, at 1,585,786 downloads/month and 5,540 stars, pushed 2026-08-21. Added as a challenger, placed last below pdoc, keeping the section at 5 of 5. Approved via verdict preview. Co-Authored-By: Claude --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index be8f3647..2d92f12b 100644 --- a/README.md +++ b/README.md @@ -696,9 +696,9 @@ _Libraries for generating project documentation._ - [sphinx](https://github.com/sphinx-doc/sphinx/) - Python Documentation generator. - [awesome-sphinxdoc](https://github.com/ygzgxyz/awesome-sphinxdoc) - [mkdocs-material](https://github.com/squidfunk/mkdocs-material) - A documentation framework and Material Design theme built on MkDocs. -- [mkdocs](https://github.com/mkdocs/mkdocs/) - Markdown friendly documentation generator. - [diagrams](https://github.com/mingrammer/diagrams) - Diagram as Code. - [pdoc](https://github.com/mitmproxy/pdoc) - Epydoc replacement to auto generate API documentation for Python libraries. +- [zensical](https://github.com/zensical/zensical) - A modern static site generator for technical documentation, built by the Material for MkDocs team. **DevOps**