continuous documentation bedconbed-con.org/2017/files/slides/kocot-continuous_documentation.pdf ·...
TRANSCRIPT
Continuous DocumentationDaniel Kocot (@dk_1977)
bed-con 2017
22.9.2017
1
2
3
Show your hands
4
Continuous Delivery
Develop
Build
TestDeploy
Release
Agilität und Dokumentation
5
Agiles Manifest
Individuen und Interaktionen mehr als Prozesse und Werkzeuge
Funktionierende Software mehr als umfassende Dokumentation
Zusammenarbeit mit den Kunden mehr als Vertragsverhandlung
Reagieren auf Veränderungen mehr als das Befolgen eines Plans
6
Agiles Manifest
Funktionierende Software mehr als umfassende Dokumentation
7
Bedarfsgerechte Dokumentation
8
Orientierung am Leserkreis
9
10
Dokumentation von relevantem Wissen
11
Skalierbare Dokumentation
Lerneffekt durch Dokumentation
12
Dokumentationsplanung
13
Lebendige Anforderungen
14
Der Kunde im Kontext
15
Transparenz
16
Dokumentation als Inkrement
17
Verantwortlichkeit
18
Review
19
Der richtige Inhalt
20
Gestaltung
21
Umgang
22
Verteilung
DokumentationslandschaftAnleitung zur Erstellung
Wissensmanagement
Werkzeuge
23
Documentation as Code
24
Asciidoctor
25
PlantUML
26
Automatisierung durch Buildpipeline
27
Multi-Channel Dokumentation
28
Channels•Wikisysteme
•SSGs (Static Side Generators)
•PDFs
•Word-Dokumente (worst case!)
•Präsentationen
29
DEMO TIME
30