Continuous Documentation @JavaLand 2018

Transcript

1. Continuous Documentation Daniel Kocot (@dk_1977) JavaLand 2018 13.03.2018 1
4. 4 Show your hands
5. 5 Continuous Delivery Develop Build Test Deploy Release
6. Agilität und Dokumentation 6
7. 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 7
8. Agiles Manifest Funktionierende Software mehr als umfassende Dokumentation 8
9. Dokumentation als Inkrement 9
10. Transparenz 10
11. Verantwortlichkeit 11
12. Review 12
13. Der Kunde im Kontext von Dokumentation 13
14. Lebendige Anforderungen 14
15. Der richtige Inhalt 15
16. Gestaltung 16
17. 17 Retrospektive Dokumentationslandschaft Wissensmanagement
18. Werkzeuge 18
19. Documentation as Code 19
20. Asciidoctor 20
22. PlantUML 22
24. Test Driven Documentation 24 Anforderung mit Gherkin Tests mit Spock Spock Reports
25. API Dokumentation 25 25 swagger2markup Spring REST Docs
26. Buildmanagement & Buildpipelines 26
27. Multi-Channel Dokumentation 27 27
28. Wikis 28
29. Static Site Generators JBake jekyll Antora 29
30. Asciidoctor PDF speedata Publisher 30 Portable Document Format
31. 31 Documentation as a Service Spark Framework
32. DEMO 32
33. Weiterführende Informationen •Agile, frisch gebackene Dokumentation – Teil 1: JBake https://blog.codecentric.de/2017/10/jbake-agile-dokumentation-teil-1/ •Agile, frisch gebackene Dokumentation – Teil 2: PlantUML mit JBake https://blog.codecentric.de/2017/11/agile-frisch-gebackene-dokumentation-teil-2-plantuml-mit-jbake/ •Agile, frisch gebackene Dokumentation – Teil 3: Getestete Anforderungen mit JBake https://blog.codecentric.de/2018/02/agile-frisch-gebackene-dokumentation-teil-3-anforderungen-spock-jbake/ 33
34. Q & A 34