Check out Research on code documentation — when not to comment on code by . Here is an excerpt:
In this post, I summarize the findings of an extensive research project about how developers at Google find and use code documentation. The research found that for simple code, sometimes developers prefer to read the code directly. However, for more complex code, developers consult…
The full article is available here.
