Slide 1

Slide 1 text

Docs-as-Code: Anatomie einer realen Systemdokumentation Dr. Gernot Starke & Ralf D. Müller IT-Tage 2020

Slide 2

Slide 2 text

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 Wiederverwenden geeignet. Sie erleben (live), wie Sie mehrere Dokumentationsartefakte kombinieren können, für verschiedene Zielgruppen unterschiedliche Ausgaben generieren und plattformübergreifend nebenbei noch eine Website für Ihre Doku zaubern können. Wir vermitteln einerseits die zugrunde liegenden Konzepte, parallel dazu stets die praktische Umsetzung, daher gibt's relativ wenige Slides, und viel praktische Demo. Alles, was wir hier zeigen basiert auf quelloffener Software - Sie können unsere Beispiele in Github-Repositories nachvollziehen.

Slide 3

Slide 3 text

Durch Verwendung verschiedener Präsentationsmedien existiert zu dieser Session kein Foliensatz. Alle Infos gibt es jedoch auf https://docs-as-co.de bzw. https://arc42.org Das Repository unseres Beispiel ist auf https://github.com/aim42/htmlSanityCheck zu finden. Fragen zum Vortrag können gerne an Ralf.D.Mueller@docs-as-co.de gestellt werden.

Slide 4

Slide 4 text

https://leanpub.com/arc42-primer https://leanpub.com/arc42byexample

Slide 5

Slide 5 text

https://leanpub.com/praxisbuchdocs-as-code/c/nikolaus-2019

Slide 6

Slide 6 text

No content