Notes on clarifying man pages — by Julia Evans
A tour of what makes man pages easy to use: rsync's terse synopsis with a one-line option summary, strace's categorised options, curl's per-option examples, and the value of examples and tables of contents.