What nobody tells you about documentation
They are: tutorials, how-to guides, explanation and technical reference. They represent four different purposes or functions, and require four different approaches to their creation. Understanding the implications of this will help improve most software documentation - often immensely.
Not 100% agreed on all points, but this is a good framework for considering what one is doing when writing.