On: From novice to master, and back again (2013)

[hvs]

The only feeling I've gotten looking at a man page is, "well, I don't have to time to dig through all of this. Guess I'll just look at stack overflow which will have my exact use case and required parameters."

[layer8 → hvs]

In my opinion, the EXAMPLES section should be near the top of the man page and include the most common usages.

[lrobinovitch → hvs]

I love tldr for this https://github.com/tldr-pages/tldr