Schmerzen
Aktuell halten
Keiner kümmert sich drum
Vielleicht Sync Tools Docs => Code oder Code => Docs
Entspricht irgendwann nicht mehr der Realität
"Code ist schon selbsterklärend"
=> Sollte auf Kommentare beziehen
Es ist jetzt klar!!!!!
Eigener Code in 6 Monaten => warum hab ich das so gemacht ?????
Sind Requirements abgedeckt?
Use Cases
Mapping <=> ursprüngliche Anforderung
Welcher Detailgrad is überhaupt sinnvoll
Was zu dokumentieren?
Lohnt es sich überhaupt?
Welche Zielgruppen?
Wer sind meine Leser?
Wie strukturieren? => https://diataxis.fr/
Zeit fehlt??
Jetzt dauert es länger, aber Einarbeitungen später sind einfacher
Verteilt?
=> läuft auseinander
Workarounds
Werden immer eingebaut => Vorhaben, "irgendwann" mal wieder auszubessern Schon bearbeitet? Oder steht das noch aus?
Warum hat man das gemacht?
=> Verlinkungen zu Stellen im Quellcode => Im Code liegt die Wahrheit