Howto is super important to me, it's absolutely bananas how many docs seem to assume you understand the whole library and don't explain any surrounding context or how things effect other things in the context.

Especially bad in 100% documention requirement shops where you get stupid things like '@param foo - Control <foo>' where having some examples would be much more useful than a wall of those parameter 'descriptions'.