Websites herunterladen, die RDoc nutzen

Über RDoc

Dokumentationsgeneratoren sind seltsame Bewohner eines Index von Webtechnologien, denn niemand nimmt sie so in Betrieb wie einen Server oder einen Warenkorb. RDoc läuft auf dem Rechner eines Entwicklers oder in einem Build-Job, liest Ruby-Quelldateien samt ihrer Kommentare und schreibt statisches HTML. Ins öffentliche Internet gelangt dieses HTML. Ein Treffer bedeutet hier also, dass unser Crawler die Ausgabe des Generators erkannt hat und nicht den Generator selbst.

RDoc stammt aus dem Jahr 2001 und ist für Ruby geschrieben, was das Tool an ein einzelnes Ökosystem bindet statt an einen allgemeinen Markt. Die Ausgabe taucht meist in veröffentlichten API-Referenzen von Open-Source-Bibliotheken auf, in interner Dokumentation, die auf einer Subdomain eines Unternehmens abgelegt ist, und auf archivierten Projektseiten. Ein Treffer beschreibt deshalb, was ein Host veröffentlicht, und nicht, worauf der Rest der Website läuft, und beides sollte man nicht verwechseln, wenn der Eintrag für die gezielte Ansprache genutzt wird.

Als Lizenz ist Ruby or GPL-2.0-only verzeichnet, und das Tool wird seit Langem mit der Distribution der Sprache selbst ausgeliefert. Software, die gebündelt mitkommt, hinterlässt keine Kaufspur, keine Kundenliste und keinen Download-Zähler, den man zitieren könnte, weshalb die Erkennung über einen Crawl eine der wenigen Möglichkeiten ist, ihre Verbreitung überhaupt zu beobachten. Wir führen das Tool in der Kategorie Documentation, einem Sammelbecken für alles, was weder Server noch Framework noch kommerzielle Plattform ist.

Stand Oktober 2026 verzeichnet der Index die Signatur auf 1 Website. Eine so kleine Zahl sollte man als Untergrenze der Erkennung lesen, und die Gründe dafür sind typisch für die Ausgabe von Dokumentation. Generierte Seiten werden oft mit eigenen Themes neu gebaut, die den Footer und die Klassennamen entfernen, auf die ein Fingerabdruck angewiesen ist. Dokumentation liegt häufig bei gemeinsam genutzten Dokumentationsdiensten unter fremdem Markup, und die Konventionen des Generators selbst haben sich über die Releases hinweg geändert, sodass ältere und neuere Ausgaben unterschiedlich aussehen.

Forscher, die sich für diesen Eintrag interessieren, kartieren meist Entwickler-Ökosysteme, statt etwas zu kaufen: Paket-Registries, Anbieter von Entwickler-Tools, die die Größe einer Sprach-Community abschätzen, und Sicherheitsteams, die nach Dokumentationsbäumen suchen, die auf öffentlichen Hosts interne Klassen- und Methodennamen preisgeben. Die Prüfung einer einzelnen Domain zeigt, ob genau dieser Host Ruby-Dokumentation veröffentlicht. Der herunterladbare Datensatz zeigt, welche Hosts im gesamten Crawl das tun, zusammen mit den Servern, Analytics-Tools und dem Hosting, auf denen sie laufen, und diese umgekehrte Frage lässt sich nicht Domain für Domain stellen.