Websites herunterladen, die MkDocs nutzen

Über MkDocs

Vieles, was wir in der Kategorie Documentation führen, soll Menschen ohne technischen Hintergrund das Veröffentlichen erleichtern. MkDocs soll Entwicklern helfen, Dokumentation zu veröffentlichen, und dieser Unterschied prägt das Tool in jeder Hinsicht. Der Generator erschien 2014 unter der Lizenz BSD, ist in Python geschrieben und macht aus einem Verzeichnis mit Markdown-Dateien und einer einzigen YAML-Konfiguration eine statische Dokumentations-Website. Stand Oktober 2026 sehen wir den Generator auf 1.994 Websites.

Eine so gebaute Website hat keine Datenbank, keinen Login und keinen redaktionellen Workflow. Die Inhalte liegen in einem Repository neben dem Code, den sie beschreiben, und veröffentlicht wird, wenn eine Pipeline läuft. Die Dokumentation wird deshalb zusammen mit der Software versioniert, Änderungen durchlaufen ein Code-Review, und wer die Seiten schreibt, hat auch das Produkt geschrieben. Jede Website, auf der wir diesen Generator erkennen, gehört mit hoher Wahrscheinlichkeit einem Softwareteam.

Die Versionsdaten spiegeln diese Zuständigkeit wider. Wir erfassen 30 verschiedene Releases im Umlauf und sehen Version 1.6.1 häufiger als jede andere, und die Konzentration ist enger, als sie es bei einem Publishing-Tool für Endnutzer wäre. Websites, die per Continuous Integration neu erzeugt werden, übernehmen beim Build die Version, auf die die festgelegte Abhängigkeit gerade aufgelöst wird. Die Versionsverteilung zeigt deshalb eher, wie sauber Abhängigkeiten gepflegt werden, als wie oft jemand von Hand aktualisiert. Ein veralteter Build auf einer Dokumentations-Website bedeutet meist eine veraltete Pipeline und nicht einen abwesenden Administrator.

Die kommerzielle Lesart liegt auf der Hand. Eine Liste von Dokumentations-Websites ist eine Liste von Unternehmen, die Software ausliefern und schon so weit sind, dass sie ihre Software dokumentieren. Entwicklertool-Anbieter, API-Plattformen, Hosting-Dienste für Dokumentation, Agenturen für technische Redaktion und Suchprodukte für Dokumentationen wollen genau diesen Bestand, und er lässt sich auf anderem Weg kaum zusammentragen, denn diese Websites verteilen sich auf Subdomains von Unternehmen und auf Projektdomains, die kein Verzeichnis sammelt.

Die Erkennung hängt von Merkmalen ab, die die erzeugte Ausgabe hinterlässt, vor allem von Generator-Metadaten und der Asset-Struktur des Standard-Themes und des Material-Themes. Ein Team, das Metadaten entfernt, die Ausgabe über ein stark angepasstes Theme ausliefert oder die Dokumentation hinter einem Unternehmens-Proxy verbirgt, verschwindet vollständig aus unserem Blickfeld. Die Zahl ist deshalb eine Untergrenze der tatsächlichen Nutzung.

Eine Einzelabfrage zu einer Domain zeigt, ob die Dokumentation eines Unternehmens mit diesem Generator läuft. Die herunterladbare Datei zeigt, welche Unternehmen überhaupt Dokumentation betreiben, auf welchen Domains und Subdomains, bei welchen Hostern und welche davon seit dem letzten Export den Generator gewechselt haben. Eine Frage über einen ganzen Bestand lässt sich nicht Domain für Domain stellen.