Microsoft has traced the worldwide Microsoft 365 outage on November 12–13, 2026, to a hidden Windows defect that overwhelmed servers handling cloud connections.
I was always onboard to RTFM, that was my primary learning tool, but some of those fucking manuals were written by people who are entirely incapable of writing documents in a way that people who don’t already know the contents can understand it.
Once you know something, almost any manpage is fine for reference, but few of the manpages actually teach you cleanly how to use a command from a beginner standpoint.
That’s been my biggest gripe with man pages since I first tried Linux decades back. I couldn’t figure it out because most every page back then was written by an engineer for other engineers.
I was always onboard to RTFM, that was my primary learning tool, but some of those fucking manuals were written by people who are entirely incapable of writing documents in a way that people who don’t already know the contents can understand it.
Once you know something, almost any manpage is fine for reference, but few of the manpages actually teach you cleanly how to use a command from a beginner standpoint.
That’s been my biggest gripe with man pages since I first tried Linux decades back. I couldn’t figure it out because most every page back then was written by an engineer for other engineers.
There are occasional ones that are ok, man ip for example include examples, but you have to make it below lengthy Synopsis and Options
Yes, at a minimum, I feel like every man page would be well served by a single example near the top that is something like
Instead it’s “grep [-the entire alphabet, twice] [-12 other options you probably won’t use] [cryptic arguments]”
The description is helpful, at least.
I recommend installing
tldrpackage, it does what you are just describing.Well, that looks amazing. Thank you!
Some of them are really well done
Some of them look like they’re summoning a Great One