Docs-as-Code: Anatomie einer realen Systemdokumentation
In diesem Vortrag zeigen Ralf und Gernot anhand eines (kleinen aber) realen Projekts, wie Sie Schritt für Schritt den Docs-as-Code-Ansatz verwirklichen können. Von Anforderungs- und Architekturdokumentation bis hin zu Developer-Guidelines ist alles einfach, pragmatisch und zum direkten Konsum („wiederverwenden“) geeignet. Sie erleben (live), wie Sie mehrere Dokumentationsartefakte kombinieren können, für verschiedene, zielgruppenunterschiedliche Ausgaben generieren und plattformübergreifend nebenbei noch eine Website für Ihre Doku zaubern können. Neben diversen Good Practices zeigen Ralf und Gernot auch die Probleme und Grenzen einiger Ansätze auf. Format: Viel Demo, wenige Slides, Github-Repository zum selbst ausprobieren.