I dunno, I find them much better than most of the documentation I&#x27;ve worked with.  I agree with you for beginners, since when I first started reading man pages and such, I wanted to rip my eyes out.  But after a while, once I learned why the documentation was written the way it was, the flow of it started to make more and more sense. Though, in a lot of ways this comes from personal opinions that gnu tools and by extension, gnu&#x2F;linux, <i>should</i> be difficult in the worse-is-better sense.<p>These days, when looking at documentation, my go-to example for awful documentation is salt. Because, well, this is utter bullshit:<p>$ man salt 2&gt;&#x2F;dev&#x2F;null | wc -l<p>133324