FSCK 2024 - Warum keine Dokumentation das Leben deiner Kollegen kosten könnte

Alle die Code schreiben kennen es: Man hat ein neues, eher kompliziertes Feature implementiert und müsste jetzt eigentlich das ganze dokumentieren, aber wie fange ich an? Was schreibe ich, und ist das überhaupt hilfreich?
Jascha Kasper
cfp.ctbk.de/fs...
#fsck2024 #HardSoftware

[@alxhu]

Ich finde den Titel nicht gut gewählt, weil während des Vortrages (nahezu?) gar nicht auf die Ausgangsfrage eingegangen wird. Trotzdem guter Vortrag :) war bestimmt das erste Mal für den Menschen am Redepult

[@silent6597]

Guter Vortrag doch ist der Titel nicht so gut gewählt, es geht im Vortrag zwar schon um ärgerliche Dinge aber lebensbedrohend ist drei Tage in irgendeine verrentete Library reinlesen ists glaube ich nicht. Hatte da eher auf sowas gehofft wie ein Bekannter gerne erzählt, Elektrobude die auch Anlagensteuerung machen. Da gabs tatsächlich schon beinahe Todesfälle weil Dokumentation und Anleitung ignoriert wurde, teils bei neuen Anlagen diese fehlte und somit keine Warnhinweise existierten, dass man mit bestimmten Anlagenstellungen gefährliche Zustände schaffen kann.

[@kanedaspring]

Der Titel des Vortrags passt wirklich nicht zum Inhalt. Dokumentation in Form von Übersichten, Zusammenhänge, Prozesse und alles wichtige für den Betrieb sind eine gute Basis. Dennoch, Dokumentation ist immer so ein Thema, insbesondere wenn man nicht früh Gedanken macht, was sind die Ziele, die mit der Dokumentation erreicht werden sollen. Was nicht funktioniert, brain drain mit Dokumentation abzusichern oder es soll alles beinhalten, damit ein Anfänger keine Probleme hat. Vorlagen sind gut, besser sind verschiedene Beispiele für Standard und edge cases. Ich gebe in der Regel folgendes vor "schreib das nieder was für den Betrieb und in 3-6-12 Monaten oder später (für dich als Entwickler) interessant sein wird"

[@Fla77y]

Mehr Äh/Ähm als Stoiber... Nach 3 min raus...

[@karimhammam9105]

Hello ^^