Exactly. Also I would say that not all comments are created equal. You comment your API's first, then implement/explain them with code, then describe why with

Exactly. Also I would say that not all comments are created equal. You comment your API's first, then implement/explain them with code, then describe why with more comments ;-)