Skip to content

Commit 8b55995

Browse files
committed
Updated blog post on MkDocs 2.0
1 parent 66d413f commit 8b55995

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

docs/blog/posts/mkdocs-2.0.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,8 @@ Here's a summary of [the timeline of events]:
8989
9090
The moment we learned about these plans, [we immediately started working] on what would eventually become [Zensical] – a new static site generator designed to be backward-compatible with MkDocs 1.x and a reliable long-term home for your existing documentation projects.
9191

92+
For years, we were already trying to improve MkDocs from within. We authored [12 plugins], which gave us a deep understanding of the plugin API's limitations. We conducted quantitative and qualitative analyses of the ecosystem to identify where MkDocs was falling short and talked to dozens of organizations. We raised these issues and repeatedly got nowhere. When the new direction of MkDocs 2.0 became apparent, the thinking was already done.
93+
9294
We considered forking MkDocs, but quickly realized it wasn't viable: every plugin in the ecosystem has a direct dependency on `mkdocs`, which means forking MkDocs would require forking every single one of its [300 plugins]__like moving an entire city at once__.
9395

9496
With forking being impractical, we had to start from scratch.
@@ -108,6 +110,7 @@ With forking being impractical, we had to start from scratch.
108110
[a team call on August 1]: https://github.com/mkdocs/mkdocs/discussions/3671#discussioncomment-10164237
109111
[we raised objections multiple times]: https://github.com/mkdocs/mkdocs/discussions/3671#discussioncomment-10215445
110112
[a reliable, backward-compatible home]: https://zensical.org/compatibility/
113+
[12 plugins]: ../../plugins/index.md
111114

112115
## Where Zensical comes in
113116

0 commit comments

Comments
 (0)