Programmierung und Softwareentwicklung

Googles Docsy-Projekt wechselt zur Linux Foundation, um Dokumentation für KI-Agenten vorzubereiten

Das Open-Source-Projekt Docsy, das für die Dokumentation von Projekten wie Kubernetes und OpenTelemetry verwendet wird, wechselt zur Linux Foundation. Zugleich werden Funktionen entwickelt, die Dokumentation für KI-Agenten leichter lesbar machen. Das Projekt arbeitet daran, eine Methode zur Messung zu ergänzen, wie geeignet Dokumentation für die automatisierte Entdeckung, Navigation und Nutzung ist.

2026-10-07
3 Min. Lesezeit
246 Aufrufe
certi.news Editorial Team
Googles Docsy-Projekt wechselt zur Linux Foundation, um Dokumentation für KI-Agenten vorzubereiten

Das Open-Source-Projekt Docsy, das von Google zum Erstellen von Dokumentationsseiten mit dem statischen Seitengenerator Hugo entwickelt wurde, wechselt zur Linux Foundation. Dies geschieht zu einem Zeitpunkt, an dem technische Dokumentation zu einer direkten Quelle für KI-Agenten geworden ist und nicht mehr nur für Entwickler dient.

Erin McKean, Developer-Relations-Ingenieurin bei Google und Mitglied des Docsy-Lenkungsausschusses, gab den Schritt am Mittwoch während einer Rede auf dem Open-Source-Gipfel der Linux Foundation in Europa in Prag bekannt. Der Wechsel beruht teilweise auf der Verbreitung von Docsy innerhalb des Projektökosystems, das mit der Stiftung verbunden ist. Bis Ende 2024 verwendeten es rund 2.200 Projekte, darunter Projekte der Cloud Native Computing Foundation wie Kubernetes, OpenTelemetry, gRPC und Jaeger.

Ein Dokumentationsprojekt richtet sich an ein maschinelles Publikum

Docsy wurde erstmals 2019 angekündigt. Es handelt sich um ein Open-Source-Template für technische Dokumentation, das mit offenen oder privaten Projekten verwendet werden kann. Die jüngsten Änderungen konzentrieren sich jedoch darauf, wie KI-Tools auf Inhalte zugreifen, und auf die Form der Anweisungen, die diese Tools zur Ausführung projektbezogener Aufgaben benötigen.

Seit der Version 0.15.0 im Mai kann Docsy neben der üblichen HTML-Version eine Markdown-Version jeder Seite erzeugen. Außerdem kann es eine llms.txt-Datei erstellen, die einen Index der Website-Inhalte bereitstellt. Beide Funktionen sind optional und experimentell.

In der im Juli veröffentlichten Version 0.16.0 wurde ein Upgrade-Leitfaden hinzugefügt, der so formuliert ist, dass ein automatisierter Assistent ihm folgen kann, einschließlich der Voraussetzungen, Schritte und Prüfungen. Die im August veröffentlichte Version 0.17.0 ergänzte am Anfang jeder Seite eine versteckte Anweisung für Nutzer, die llms.txt aktivieren, um zugreifende Agenten zum Website-Index zu führen. Auch diese Funktion bleibt experimentell.

Was ändert sich praktisch?

Docsy verlagert einen Teil der Aufgabe der Dokumentationsoptimierung von der bloßen Formatierung von Seiten für menschliche Leser hin zur Organisation von Inhalten, damit Modelle und Agenten sie finden, verstehen und befolgen können. Für Projekte, die auf Mitwirkende oder externe Nutzer angewiesen sind, könnte dies bedeuten, KI-Tools auf eine klarere Version der Anweisungen zu lenken, anstatt sie diese aus öffentlich zugänglichen HTML-Seiten ableiten zu lassen.

McKean zufolge kann bessere Dokumentation die Zahl der routinemäßigen Fragen verringern, die bei den Betreuern eingehen, weil Antworten den Nutzern zur Verfügung stehen, bevor ein Maintainer eingreifen muss. Das ist ein möglicher betrieblicher Vorteil für Projekte. Es bedeutet jedoch nicht automatisch, dass Agenten die Inhalte korrekt verstehen oder dass die Dokumentation automatisch präzise wird.

Der nächste Schritt: Lesbarkeit für Agenten messen

Das Docsy-Team arbeitet an dem, was es AF documentation scores nennt, also Bewertungen der Agententauglichkeit von Dokumentation. Ziel ist es, Betreuern eine Kennzahl zur Bewertung der Fähigkeit von KI-Tools zu geben, Dokumentation zu entdecken, darin zu navigieren und sie zu nutzen, anstatt sich ausschließlich auf Vermutungen zu verlassen.

Die Quelle erläutert bislang weder die Form dieser Kennzahl noch ihre endgültigen Kriterien oder den Zeitpunkt ihrer Veröffentlichung. Zudem sind die Funktionen Markdown und llms.txt sowie die damit verbundenen Anweisungen optional und experimentell. Ihre praktischen Auswirkungen hängen daher weiterhin davon ab, ob Projekte sie übernehmen, und von der Qualität der von ihnen erstellten ursprünglichen Inhalte.

Nachrichtenquelle
The New Stack - Software Development
Originalquelle öffnen ↗
c
Autor

certi.news Editorial Team

Das Wichtigste

Das Open-Source-Projekt Docsy wechselt von Google zur Linux Foundation und entwickelt Funktionen weiter, die Dokumentation für KI-Agenten leichter zugänglich und verständlich machen. Das Projekt hat experimentell die Erstellung von Markdown-Seiten und einer llms.txt-Datei hinzugefügt und arbeitet an einer Kennzahl zur Bewertung der Auffindbarkeit, Navigation und maschinellen Nutzbarkeit von Dokumentation.

  • Docsy ist ein Open-Source-Template zum Erstellen von Dokumentationswebsites mit dem statischen Website-Generator Hugo und wurde bis Ende 2024 von rund 2.200 Projekten genutzt.
  • Das Projekt wechselte zur Linux Foundation, weil es innerhalb ihres Projektökosystems weit verbreitet ist, unter anderem bei Kubernetes, OpenTelemetry, gRPC und Jaeger.
  • Seit Version 0.15.0 kann Docsy eine Markdown-Version der Seiten und eine llms.txt-Datei erzeugen, die einen Index der Website-Inhalte bereitstellt. Beide Funktionen sind jedoch optional und experimentell.
  • Version 0.16.0 fügte einen Upgrade-Leitfaden hinzu, dem ein automatisierter Assistent folgen kann. Version 0.17.0 ergänzte eine Anweisung, die Agenten bei aktiviertem llms.txt zum Website-Index führt.
  • Das Docsy-Team arbeitet an AF documentation scores, um zu messen, wie gut KI-Agenten Dokumentation entdecken, darin navigieren und sie nutzen können.
  • Die Nutzung dieser Funktionen garantiert nicht, dass Agenten die Dokumentation korrekt verstehen. Die praktische Wirkung hängt von der Akzeptanz durch die Projekte und der Qualität der ursprünglichen Inhalte ab.

FAQ

Was ist das Projekt Docsy?

Docsy ist ein von Google erstelltes Open-Source-Template zum Erstellen technischer Dokumentationswebsites mit dem statischen Website-Generator Hugo.

Welchen Nutzen hat die llms.txt-Datei in Docsy?

Sie stellt einen Index der Dokumentationsinhalte bereit und hilft dabei, KI-Agenten zu den Inhalten zu führen. Die Funktion bleibt optional und experimentell.

Was sind AF documentation scores?

Dabei handelt es sich um eine Kennzahl, die das Docsy-Team entwickelt, um zu bewerten, wie gut KI-Tools Dokumentation entdecken, darin navigieren und sie nutzen können.

Sind die neuen Docsy-Funktionen bereits stabil?

Nein. Die Markdown- und llms.txt-Funktionen sowie die damit verbundenen Anweisungen wurden als optional und experimentell beschrieben.

Aus derselben Kategorie

Das könnte Sie interessieren

Alle Nachrichten anzeigen