3 ms·
sorry i'm gonna sound like i'm making an argument for authority but why do man pages have to appeal to the "average" person anyways? complex tasks require
by kkarakk 6y ago
sorry i'm gonna sound like i'm making an argument for authority but why do man pages have to appeal to the "average" person anyways?
complex tasks require complex explanations to avoid weird hangups/errors.
every time i see people complain about the complexity of manpages i always wonder what their work looks like if manpages is the blocking issue to their understanding of a tool
- ahartmetz 6y agoI would agree that most manpages are pretty useful and that they don't necessarily need to be tutorials (it would be against Unix traditions, haha). Git's manpages and CLI are just a particularly bad word soup.
- jl2718 6y agoTODO: man page search engine with semantic term substitution (e.g. Bert). Possibly trained on stackoverfow.