Hear hear. Write comments which explain, which document, which clarify, not which say exactly what the code says. Also your comments should be testable :D (Yay #rustlang)

Testable comments is something I should really look into