News for hackers. Stuff that matters.
Re:Simplified and community-driven man pages by baddox on Sunday November 26, 2017 @01:40AM (#15779726)
Usually it’s just me trying to do some task and not caring to ever “learn the command” with any depth (because I don’t use it enough for that to be worthwhile). That’s why examples are great. I can probably usually just scan the examples and quickly recognize the one that does the thing I want to do.
Re:Simplified and community-driven man pages by baddox on Sunday November 26, 2017 @01:48AM (#15779746)
Of course, sometimes this attitude of mine is a problem. The most obvious example for me is git, which I use nearly every day, but still have an embarrassingly shallow understanding of. Any time something “goes wrong” I’m googling for a magic command to fix it, or resorting to crude measures like copying the whole repo directory and resetting hard.
Re:Simplified and community-driven man pages by Qwertious on Sunday November 26, 2017 @08:37PM (#15784196)
>The most obvious example for me is git, which I use nearly every day, but still have an embarrassingly shallow understanding of. Any time something “goes wrong” I’m googling for a magic command to fix it,

This is basically the reason I use Mercurial. It actually makes sense without getting a bloody degree in "how to use your DVCS", and the help is quite nice, and not a godawful clusterfuck like some popular DCVSes that were developed by developers of major FOSS kernels circa 2005.