Wie wäre es, wenn wir und unser bevorzugtes LLM die gleiche technische Dokumentation verwenden würden? Technische Dokumentation für ein System kann heute so aufgebaut werden, dass sie gleichermaßen für Menschen als auch für LLMs verfügbar ist. Eine Source of Truth für beide Konsumentengruppen mit unterschiedlichen Anforderungen. Doc-As-Code bildet hierfür die Grundlage und kann seine Vorteile hier ausspielen.
In diesem Vortrag sehen wir uns an, wie ein solches Dokumentationssystem aussehen kann und welche Struktur sich hierfür eignet, um Systeme durchgängig zu dokumentieren, von der Produktvision, über Architektur bis hin zu Betrieb, auch über die Grenzen eines einzelnen Systems hinweg. Ergänzt durch ein RAG-System und angebunden über einen MCP-Server können alle Informationen auch organisationsweit für LLMs und Agenten zur Verfügung gestellt werden.
Am Ende stehen eine bessere Dokumentation und eine bessere Developer Experience. Dabei wird auch auf Risiken und limitierende Faktoren eingegangen.
Wie ein solches System aufgebaut werden kann, wird beispielhaft mit Hilfe von Antora, AsciiDoc, Agent Skills und einem RAG-System gezeigt.