[collyw]

Comments should explain why you are doing something while method names are a guide to what they are doing. I see them as for different purposes and one should not replace the other.

[mercurial]

Absolutely, unless you're writing end-user documentation.