IT:AD:Code Comments
Summary
Writing code is expensive.
Combine that fact with the reality of staff moving on, being replaced by potentially less skilled developers and the maintenance value of writing helpful documentation aimed at developers right where they need it – in the code – becomes obvious.
But there is a point where comments don't add maintenance value: