Many of the GNU manuals are incredibly good. For example, the diff manual includes worked examples: https://www.gnu.org/software/diffutils/manual/html_node/Example-Context.html
What's the secret? My docs are getting better, but they're not on this level.