It's Not Enough to Say What it Does
http://www.artima.com/weblogs/viewpost.jsp?thread=61979

McManus, Eamonn
Artima
2004

Abstract:

All too often, developers think that documenting their new creations just means writing a detailed technical description of what it does. In a sense, they're explaining things to themselves. But what you really need to do is explain things to someone who's coming across your stuff for the first time.