March 15, 2026
Docs vs TLDR: choose your fighter
Examples for the tcpdump and dig man pages
Old-school manuals get a glow-up as devs cheer, TLDR diehards grumble, and a legend drops in
TLDR: Julia Evans added beginner examples to official manuals for tcpdump and dig, making scary tools feel usable. Comments split between TLDR fans and man-page purists, with a tcpdump co-author cameo and calls for AI to help—proof that clearer docs matter to everyone trying to just get stuff done.
Julia Evans just sprinkled beginner-friendly examples into the official manuals for two intimidating tools—tcpdump (a network traffic watcher) and dig (a website lookup helper)—and the internet lit up. Fans say it’s the rare upgrade that helps real people: “examples are gold,” cried one, framing it like giving flashcards to everyone who’s ever stared at a blank terminal. The updates are live in the dig man page and the refreshed tcpdump examples, and yes, they’re actually understandable.
Then came the scuffle: the TLDR crowd—who prefer quick cheat sheets—argued, “why not just add them to tldr?” Others clapped back that the official docs should be the first stop, not a scavenger hunt. Meanwhile, OG cred arrived as a surprise cameo: tcpdump’s co-author showed up with an origin-story talk, turning the thread into a mini history lesson. And when Evans casually mentioned she wrote a tiny script to avoid learning an ancient doc format, the AI chorus chimed in: “this is an ideal project for AI,” sparking jokes about bots writing manuals that humans can finally read.
The vibe? Hopeful chaos. People are giddy that dry manuals can be friendly, snarking that “docs so good you won’t need Stack Overflow,” and quietly admitting: maybe examples aren’t just training wheels—they’re the bike.
Key Points
- •Julia Evans added or improved beginner-focused examples in the tcpdump and dig man pages.
- •The goal was to include the most basic usage examples for infrequent or new users.
- •Reviewers (including Denis Ovsienko, Guy Harris, and Ondřej Surý) contributed to ensuring accuracy.
- •Evans highlights a tcpdump tip: when using “-w out.pcap”, adding “-v” shows a live packet capture summary.
- •To avoid writing roff directly, Evans wrote a simple Markdown-to-roff converter instead of using Pandoc.