Package: mkdocs
Version: 1.6.1+dfsg1-2
Severity: serious

mkdocs is kind of in turmoil. an incompatible 2.0 release came out. it
was covered by the mkdocs-material folks in:

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

and led to them rewriting mkdocs from the ground up into a separate
project called zensical, which has a RFP in #1145065. it's not fully
backwards compatible with mkdocs (yet) nor will it be byte-for-byte
identical anyways.

Another view of the collapse was documented here in March 2026:

https://fpgmaas.com/blog/collapse-of-mkdocs/

So other folks have forked mkdocs. The most promising seems to be
properdocs:

https://properdocs.org/

There's a little bit of drama in the background of how it was created,
visible here:

https://github.com/orgs/ProperDocs/discussions/1

In there, you can see that properdocs folks actually took over the
mkdocs pypi namespace for a while, and the zensical maintainer has
called out properdocs maintainers for "acting in bad faith" in:

https://github.com/squidfunk/mkdocs-material/issues/8581#issuecomment-4198060422

zensical maintains a timeline of this fiasco in:

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/#august-2026

Still, it looks like paperdocs is the best maintained (or most
well-known?) mkdocs fork out there and perhaps we should just switch
to it.

Either way, mkdocs is currently unmaintained and I don't think it
should be released in Debian 14.

-- System Information:
Debian Release: 13.7
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 
'stable-debug'), (500, 'stable'), (1, 'experimental'), (1, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 6.12.107+deb13-amd64 (SMP w/16 CPU threads; PREEMPT)
Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages mkdocs depends on:
ii  fonts-font-awesome               5.0.10+really4.7.0~dfsg-4.1
ii  ghp-import                       2.1.0-3
ii  libjs-bootstrap5                 5.3.5+dfsg-4
ii  libjs-jquery                     3.6.1+dfsg+~3.5.14-1
ii  libjs-lunr                       2.3.9~dfsg-2
ii  mkdocs-get-deps                  0.2.0-2
ii  python3 [python3-supported-min]  3.13.5-1
ii  python3-click                    8.2.0+0.really.8.1.8-1
ii  python3-importlib-metadata       8.7.0-1
ii  python3-jinja2                   3.1.6-1
ii  python3-livereload               2.7.1-0.1
ii  python3-lunr                     0.8.0-1
ii  python3-markdown                 3.7-2+deb13u1
ii  python3-markupsafe               2.1.5-1+b3
ii  python3-mergedeep                1.3.4-4
ii  python3-packaging                25.0-1
ii  python3-pathspec                 0.12.1-1
ii  python3-pyyaml-env-tag           0.1-3
ii  python3-watchdog                 6.0.0-1
ii  python3-yaml                     6.0.2-1+b2
ii  sphinx-rtd-theme-common          3.0.2+dfsg-2

mkdocs recommends no packages.

Versions of packages mkdocs suggests:
pn  mkdocs-doc     <none>
ii  nodejs         20.19.2+dfsg-1+deb13u3
ii  python3-babel  2.17.0-1

-- no debconf information

Reply via email to