Aller au contenu

Properdocs

La survie de mKdocs est compromise :

  • Sa future version, 2.00, ne serait plus en chantier depuis 18 mois. La version actuelle 1.x ne serait plus maintenue à partir de novembre prochain.

  • Oleh Prypin (alias oprypin) était le mainteneur principal de MkDocs depuis plusieurs années jusqu'à ce que l'auteur historique du projet reprenne la main et le bloque.

  • En mars 2026 Oleh aurait d'abord tenté de récupérer le nom mkdocs sur PyPI pour reprendre la maintenance sous ce nom, plan finalement abandonné, puis a lancé ProperDocs comme projet séparé et clairement identifié.

ProperDocs est un remplacement direct ("drop-in replacement") de MkDocs 1.x :

  • On remplace pip install mkdocs par pip install properdocs, et la commande mkdocs build devient properdocs build, sans autre changement. Les plugins existants doivent conserver leur nom actuel même s'il contient "mkdocs", ils fonctionneront tels quels sans que leurs auteurs aient besoin de créer un projet renommé. Il n'est pas nécessaire de renommer mkdocs.yml en properdocs.yml — c'est optionnel.

  • À son lancement, le projet est présenté comme un remplacement exact de MkDocs avec seulement quelques correctifs critiques ajoutés (une démarche volontairement prudente et conservatrice, pas une réécriture).

  • les deux thèmes intégrés (mkdocs et readthedocs) ont été sortis de l'installation par défaut pour alléger le paquet de base, c'est le seul changement "cassant".

  • Concrètement : il faudra juste ajouter une dépendance supplémentaire (le paquet du thème readthedocs) en plus de properdocs, sans toucher au reste de la configuration.

  • ProperDocs est une continuité peu risquée. ProperDocs est porté par la personne qui maintenait déjà MkDocs au quotidien ce n'est pas un pari sur un nouvel écosystème comme Zensical.

  • La sécurité de Mkdocs serait assurée jusqu'en novembre prochain.