One of my pet peeves has always been the many different, sometimes very
original ways in which CLI tools handle help requests. POSIX sets the canon:
--help is how we ask for help. But no, some tools1 want to be
original at the worst moment: when their users are struggling, looking for
It’s somewhat consolatory to learn that I’m not alone in this fight. The other day I landed on Clayton Craft’s blog. His rant on the topic splendidly concludes with the following assessment:
If you know your user is asking for help, show them the damn help. It serves no one to chide them for not guessing the specific way your app wants them to ask for help. Better yet, support a more “common” way to allow users to ask for help if your app doesn’t already.
I agree wholeheartedly.
- I’m looking at you, NuGet. [return]