Provision has been made within scaffolder to generate help as both a command listing, and also as specific help for particular commands.
Needs to be completed.
I noticed that you’re using ReST for your documentation, which suggests you’re familiar with Python.
If that’s the case, may I recommend modeling your efforts towards an experience like those seen in these Python modules:
Node.js isn’t Python. But what I’m trying to say is, the more programmer-friendly a help-text generator is, the more user-friendly the CLI will be.
From this project’s README, I’m guessing that you share my frustration with command-line tools that have crappy help (or sometimes no help!). When the tools for writing command-line applications are good enough, this doesn’t happen.
I think the key ingredients for this are as follows: