Forum: Sonstige Fragen zu Delphi
Delphi
by BUG,
4. Jun 2013
Wobei ich unverständlichen kommentierten Code bevorzugen würde, wenn die Alternative unverständlicher Code ohne Kommentare ist.
Gut zu kommentieren üben kann man nur, wenn man überhaupt kommentiert und sich überflüssige Kommentare abzugewöhnen kosten meiner Erfahrung nach weniger Überwindung, als überhaupt mit kommentieren anzufangen.
Allerdings könnte man solche Sachen auch gut wegkapseln...
Forum: Sonstige Fragen zu Delphi
Delphi
by BUG,
2. Jun 2013
Hinweise auf Entwurfsmuster
Quellen und wichtige Eigenschaften der verwendeten Algorithmen
Dokumentation von Sachen, deren Gründe sonst schlecht aus dem Code ersichtlich wären.
(zB. Maßnahmen gegen das Auftreten von False Sharing)
Gründe für Lösungen, wo man sich gegen das intuitive/kanonische Vorgehen entschieden hat.
(zB. Dokumentation für Workarounds bei Fehlern in verwendeten...