[sethrq]

I agree, no one type of documentation can live in a vacuum. Ideally, javadoc, sample code, tutorials, diagrams, and summaries/explanations would be present for every code base. But in reality I find even a few simple diagrams combined with a insightful description is infinitely better than pages of minimal javadoc.