Another problem is that people skim to the "most important bits" without knowing they're skipping something important. Then some of those people complain how the manual is shit.

I guess it could be shit if it is way too verbose though.