there are many reasons to write the docs even before the tests. in this talk i explained why. - docs get ready when software is - there are complete and up to date - quality of program inceases - when done properly it even adds much more dev time

1. Dokumentation Schreiben

2. Briefe schreiben ist schön

3. Briefe schreiben ist schön

4. Dokumentation

5. Wir haben Beschränkungen
Inhalt
Zeit

6. Wie wird Dok. geschrieben
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

7. Wie wird Dok. geschrieben

8. Probleme

9. Probleme
Schreiber haben keine Ahnung

10. Probleme
Schreiber haben keine Ahnung
Leute fühlen das !

11. Probleme
Schreiber haben keine Ahnung
Leute fühlen das !
Schreiber quälen die Entwickler

12. Probleme
Schreiber haben keine Ahnung
Leute fühlen das !
Schreiber quälen die Entwickler
Lange

13. Probleme
Schreiber haben keine Ahnung
Leute fühlen das !
Schreiber quälen die Entwickler
Lange
Viel zu lange

14. Probleme
schlecht geschrieben
unorganisiert
immer veraltet
nie vollständig

15. DDD

16. Bullshit Bingo

17. DDD ?

18. DDD !
Documentation
Driven
Development

19. DDD
Wie TDD ???

20. 3 Teile eines Programmes
Dokumentation
Tests
Code

21. In dieser Reihenfolge
Dokumentation
Tests
Code

22. Vorteile (Hypothese)

23. Vorteile (Hypothese)
Dok. ist qualitativ besser

24. Vorteile (Hypothese)
D. & Code ist qualitativ besser

25. Vorteile (Hypothese)
D. & Code ist qualitativ besser
(gute Programme brauchen kein D.)

26. Vorteile (Hypothese)
D. & Code ist qualitativ besser
D. schreiben geht schneller

27. Vorteile (Hypothese)
D. & Code ist qualitativ besser
D. schreiben geht schneller
D. hält kein Release zurück

28. Vorteile (Hypothese)
D. & Code ist qualitativ besser
D. schreiben geht schneller
D. hält kein Release zurück
Dok. synchron mit Code

29. 4 Arten der externen Dok.
Übersicht
Tutorien
Problemlösungen
Referenz

30. Gefühl
Übersicht
Tutorien
Problemlösungen
Referenz

31. Gefühl

32. Übersicht
wenige Informationen
ungenau erklären
Assoziationen wecken
Wo ist was? (Optik!)

33. Lernen Durch Nachmachen
Übersicht
Tutorien
Problemlösungen
Referenz

34. Lernen Durch Nachmachen

35. Tutorial
ganz einfach anfangen
alles Beschreiben (<Worte)
kleine Schritte (Erfolge!)
explain as you go
Niveau vorher festlegen

36. 4 Arten der externen Dok.
Übersicht
Tutorien
Problemlösungen
Referenz

37. Problemlösungen
Fragen öffnen das Hirn
Sprache wie im Programm
zweigleisig lehren, wiederholen
Danach Absicht erklären

38. Knapp und Vollständig
Übersicht
Tutorien
Problemlösungen
Referenz

39. Dokumentation
intern
extern

40. Halte beides getrennt !
Code (techn. Details)
Dokumentation

41. Halte beides getrennt !
für Entwickler
für Benutzer

42. Unterschiedliches Format
# (POD)
POD

43. Interne Dokumentation
Kommentare in sauberen Kode (#)
Techn. Berichte in extra .pod

44. Pod::Coverage
Nur für nachlässige
Programmierer

45. Pod::Coverage ?

46. Module::Starter ?

47. PBP 7.2

48. Old School
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

49. Projekt definiert Ziel
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

50. Hab Ich Bereits
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

51. Code und Inhalt
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

52. Data::Dumper
Mindmaps
Listen
Leitern

53. Wo zuerst ?
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

54. Schreiberlinge gesucht
Ziel formulieren
Informationen sammeln
Infos organisieren
Anfangen !
Korrekturen

55. Bücher

56. Dokumentation Schreiben

57. Dokumentation Schreiben

58. Danke