Websites herunterladen, die Retype nutzen

Über Retype

Dokumentations-Websites haben eine ungewöhnliche Eigenschaft: Sie werden einmal generiert und dann bis zum nächsten Release in Ruhe gelassen. Retype gehört zu der Familie von Tools, die aus einem Ordner mit Markdown eine durchklickbare Website mit Suche, Navigation und Theme machen, und die Ausgabe ist statisch, sodass unser Crawler das Markup sieht, das der Generator an dem Tag erzeugt hat, an dem zuletzt jemand den Build angestoßen hat.

Die Folge: Das Versionsfeld bedeutet hier etwas, was es bei einer laufenden Anwendung nicht bedeutet. Den Server hinter einer laufenden Website kann man patchen, ohne dass jemand die Inhalte anfasst. Bei einer generierten Website geht das nicht, denn ihre Version wird beim Build eingefroren und bleibt es, bis jemand sie neu generiert. Stand Oktober 2026 erfassen wir Retype auf 58 Websites in 11 verschiedenen Versionen, wobei Version 4.6.0 in unseren Daten häufiger vorkommt als jede andere. Die Versionsverteilung lässt sich durchaus als Karte veralteter Dokumentation lesen. Eine Website auf einem alten Generator-Release ist eine Website, deren Dokumentation lange nicht neu gebaut wurde, was meist bedeutet, dass auch das dokumentierte Produkt lange kein neues Release mehr hatte.

Der Einsatz verrät auch etwas über die Arbeitsweise eines Teams. Wer einen Generator statt einer gehosteten Dokumentationsplattform wählt, entscheidet sich dafür, die Dokumentation im Repository zu halten, im Code-Review und unter derselben Versionskontrolle wie die Software, und Entwicklerzeit statt eines Abo-Postens aufzuwenden. Das Lizenzmodell ist Freemium: Eine kostenlose Stufe deckt kleine Projekte ab, bezahlt wird erst, wenn ein Team mehr braucht, und deshalb vermischt die Zahl Hobby-Repositories, interne Handbücher und kommerzielle Produkte, die eine kostenpflichtige API dokumentieren. Unsere Einordnung in die Kategorie Static site generator passt bestenfalls grob, denn zum Zeitpunkt einer Anfrage wird hier nichts verwaltet.

Die Erkennung stützt sich auf generiertes Markup und Asset-Pfade, und eine statische Website lässt sich leicht davon befreien. Teams, die unter ihrer eigenen Domain veröffentlichen, ein Content Delivery Network vorschalten oder das Theme stark anpassen, können die Merkmale entfernen, an denen sich der Generator erkennen lässt, und es bleibt keine Laufzeitumgebung übrig, die sich selbst bemerkbar machen könnte. Der zu erwartende Fehler geht in Richtung Untererfassung. Die Version, die wir angeben, ist außerdem die beim Build eingetragene Version, nicht unbedingt das Release, das auf dem Rechner installiert ist, der den Build erzeugt hat. Behandeln Sie sie deshalb als Build-Protokoll und nicht als Bestandsaufnahme dessen, was das Team heute einsetzt.

Der Kreis der Interessenten für eine solche Liste ist klein und weiß, was er will. Anbieter von Dokumentationsplattformen finden damit Teams, die sich bereits auf Documentation as Code festgelegt haben, und das Gespräch ist dann kürzer, als wenn man erst die Idee selbst verkaufen müsste. Unternehmen aus dem Bereich Entwicklerwerkzeuge suchen damit Produkte mit einer öffentlichen API, für die sich eine Integration lohnt. Wer diesen Werkzeugmarkt untersucht, braucht den gesamten Bestand, denn der Anbieter Object.NET veröffentlicht keine Kundenliste, und eine generierte Website telefoniert nicht nach Hause. Eine Abfrage bestätigt eine einzelne Website. Erst der Export zeigt, wie groß die Gruppe ist, wie alt ihre Builds sind und wo sie sich mit den konkurrierenden Generatoren überschneidet.