Slide 43
Slide 43 text
Dokumentation "Why"
DESIGN COMMENTS
... The design comment basically states how and why a
given piece of code uses certain algorithms, techniques,
tricks, and implementation.
It is an higher level overview of what you'll see
implemented in the code.
With such background, reading the code will be simpler.
Moreover I tend to trust more code where I can find design
notes. At least I know that some kind of explicit design
phase happened, at some point, during the development
process.