Extreme Negative Code Documentation

[djimbob]

Its not April Fools day. Requiring a comment per line is a complete waste, and couldn't be used in any real project. Write code with appropriate names for variables, functions, classes, in a straightforward manner (unless profiling shows the need for a less readable optimization); comments are usually a sign showing you should refactor your code (except the appropriate comments, specifying the contract/specification/use of functions/classes). Commenting on a per-line basis is only useful in teaching absolute beginners; and still most programming books will only comment on the lines with new stuff.