Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing. — Dick Brandon
Good code is its own best documentation. As you're about to add a comment, ask yourself, "How can I improve the code so that this comment isn't needed?" Improve the code and then document it to make it even clearer. — Steve McConnell