Hacker News new | ask | show | jobs
by pseudohadamard 100 days ago
Absolutely. manpages are useful as a reminder if you already know how the command works but can't remember what option enables foo-output, but pretty much useless for figuring out how to use the command all you get is 15 pages of options and flags in a long list. This is one thing that MSDN got right, look at, for example, the page for CreateFile, I can't link directly to the examples section but drop down to the end of https://learn.microsoft.com/en-us/windows/win32/api/fileapi/... and hit PgUp a few times (I deliberately chose an extremely complex function here, the docs for most others aren't that long).