Docs often describe what the one documenting has in mind while designing, explaining already known facts to herself/himself from the point of view past understanding the domain.

Users start fresh. If users had spent as much time as the one documenting they would probably love the documentation, but since they are new, the viewpoint differs.

Truly good and intelligent documentation tries to capture the mindset of the assumed reader.