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