Erste Seite Zurück Weiter Letzte Seite Grafik
Documentation - Comments
To Comment or Not to Comment?
Why not?
- it's easy to write poor comments
- wrong comments can be more damaging than helpful
- requirements of comments depends on skills of the programmers
- opinions about proper style are like religions
Why?
- new team members will faster be more productive
- team memory becomes independent of inviduals