News for hackers. Stuff that matters.
Re:The Surprising Power of Documentation by eviks on Monday June 12, 2023 @01:31AM (#36288810)
another key word is "searchable" documentation, and that's where man pages fail big time leading you to the likes of Google
Re:The Surprising Power of Documentation by sarnowski on Monday June 12, 2023 @01:58AM (#36288973)
What degree of „searchable“ are you missing from apropos?

https://man.openbsd.org/apropos.1

Re:The Surprising Power of Documentation by eviks on Monday June 12, 2023 @03:52AM (#36289850)
All of the basics of anything google-like: typo-friendliness with word forms and phrases, links to source, formatting of output, GUI, or not spamming the output with a dozen of lines of warnings that some man page files are missing.

Then a bunch more degrees that I could know about if the tool were more usable

Re:The Surprising Power of Documentation by BLanen on Monday June 12, 2023 @08:55AM (#36292658)
Yes.

I mostly use man pages when I already basically know the program and need to do specific thing.

Even then I don't use man itself but usually a webpage of the manfile because of UX.