5 ms·
A lot of us are "newbies" of "tar", "find", "[" and many others after years and years using *nix. According to the anti-usability mindset, this means that the u
by jmfayard 9y ago
A lot of us are "newbies" of "tar", "find", "[" and many others after years and years using *nix. According to the anti-usability mindset, this means that the users are wrong and ought to be changed, and not an hint that we should rethink how we write and consume documentation.
Edit: the wording was angrier than it needed to be.
A concrete example of a better documentation tool : https://kapeli.com/dash https://kapeli.com/dash
- microcolonel 9y agoFor what it's worth, find is truly awful, and tar is just a bit unconventional in terms of option parsing. These are stand-out failures of interface design, for which no documentation would be sufficient for all but the most regular of users.
- rene_bg 9y agoThanks for the link to Kapeli/Dash - looks like something that could really make everyday work easier!
- mjw1007 9y agoNote that the commonly-used GNU implementations of tar and find both have info documentation which is much better than the manpages.
- minusf 9y agodash is web documentation kept offline with limited search added on top of it. it's basically a browser window...
- dmitriid 9y agoWhich already makes it orders of magnitudes better than man
- vthriller 9y agoBut why? You already can search through man pages with / key in your $PAGER (more/less/most/vimpager), and across pages with `man -k`/`man -K`, and I wouldn't really call proportional fonts as "orders of magnitude" better.