Comment Re:code documents itself (Score 1) 545
I wholeheartedly agree. There's nothing worse than coming across documentation that was clearly cut-n-pasted from another function but never revised to reflect the actual function someone is documenting, or comments that are so old and out-of-date that no one remembers if they are relevant/true anymore. Writing documentation for new code is easy, it's the upkeep by other developers that completely renders it useless.
Documenting a public interface so that Doxygen can generate some good output is worth-while, or a complex mathematical expression that has a lot of constants in it, but that's where I stop.