I agree with that. Even more, I think all the documentation people should start being chastised for not providing a decent picture of two. I am a picture thinker, and code translates well to and from pictures for me. Not so much with the documentation. By analogy: I'm sure I could get an understanding of a city with written instructions on geting from various parts to other various parts. I'd do better just wandering around. However give me a map and I know it well pretty quick, especially if I can wander around with the map. Likewise with code, give me a single decent architecture or dataflow diagram and you've helped me more than a whole well written book about the codebase.