Waldo JaquithPlease, please, stop using "foo" and "bar” in code documentation. Give us real examples that mean something. Not "if (foo > bar)," but “if (height > limit)." Not “foo++” but “counter++”. Give us a logical hook to hang our hat on, not nonsense words.
Andrew Motel@waldoj @SwiftOnSecurity This but also with CLI examples. A bunch of italics and arbitrary brackets and braces gives like 1/100th of the information that a single concrete example would.
Dial Tone, Busy Signal *biiip*@starblind @waldoj @SwiftOnSecurity you are the first person I've seen complain about this... I thought I was alone for like 25 years...
To this day, I can barely understand those man and help pages.
Erwin Rossen 🔸@starblind @waldoj @SwiftOnSecurity That's why I never read man pages, but use a CLI tool called tldr. You type e.g. `tldr grep` and it spits out around 8 examples how to use grep.