News for hackers. Stuff that matters.
Re:Simplified and community-driven man pages by jmfayard on Sunday November 26, 2017 @03:41AM (#15780039)
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

Re:Simplified and community-driven man pages by microcolonel on Sunday November 26, 2017 @04:19AM (#15780128)
For 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.
Re:Simplified and community-driven man pages by mjw1007 on Sunday November 26, 2017 @05:55AM (#15780334)
Note that the commonly-used GNU implementations of tar and find both have info documentation which is much better than the manpages.
Re:Simplified and community-driven man pages by minusf on Sunday November 26, 2017 @06:11AM (#15780373)
dash is web documentation kept offline with limited search added on top of it. it's basically a browser window...
Re:Simplified and community-driven man pages by dmitriid on Sunday November 26, 2017 @11:46AM (#15781669)
Which already makes it orders of magnitudes better than man
Re:Simplified and community-driven man pages by vthriller on Monday November 27, 2017 @04:54AM (#15786123)
But 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.
Re:Simplified and community-driven man pages by rene_bg on Sunday November 26, 2017 @05:53AM (#15780328)
Thanks for the link to Kapeli/Dash - looks like something that could really make everyday work easier!