3 ms·
Honestly, no. They are not great, and it's getting silly to pretend they are. If they were, we wouldn't have stuff like tldr, cheat, bropages, and a good half o
by krick 2y ago
Honestly, no. They are not great, and it's getting silly to pretend they are. If they were, we wouldn't have stuff like tldr, cheat, bropages, and a good half of StackOverflow wouldn't exist as well, let alone LLM tools to translate your verbal request to half-broken ffmpeg command.
Man readers suck, man pages suck too, man markup language sucks, the contents of a typical manpage suck.
- shadowgovt 2y agoFundamentally, the problem is that manpages are a framework (and not actually a bad one, if everyone where to adhere to it and populate every section), but writing good documentation is an art and not a well-taught one.
- teddyh 2y ago> writing good documentation is an art and not a well-taught one. Some recommendations here: <https://www.gnu.org/prep/standards/html_node/GNU-Manuals.html https://www.gnu.org/prep/standards/html_node/GNU-Manuals.htm...>
- sgarland 2y agoWe have those because people do not know other options exist, or know, and lack the patience to read. By and large, people don't read docs, full stop. This is why you get entire stack traces being dumped into Slack, or error messages that clearly state the problem.