Hacker News Reader

They can still be both! You can flip the general structure of man pages to be examples first while still having all the complete reference material after.

View on HN

The downside of that is that searching for something would mean I'd first get the examples, and then the reference.

Or just use tldr, which already does what you want.

Reply on news.ycombinator.com