Refine CLI interface semantics #87
Labels
enhancement
New feature or request
good first issue
Good for newcomers
help wanted
Extra attention is needed
Milestone
Before setting the CLI API in stone for a long time in milestone v1.0, I suggest remodeling the semantics of the sub-commands slightly.
For example:
generate
andcalculate
are semantically not too dissimilar and generate at least some amount of cognitive friction on usage (e.g.generate
could just as well refer to generating the TOTP).I suggest e.g. the following transition:
generate
->init
(ubiquitous and well understood from modern CLI design)calculate
->attest
or simplyshow
Also refer to the request for a
status
command in #85.Great reference on modern and idiomatic CLI design e.g. here, specifically on sub-commands and
noun verb
vsverb noun
ordering here.This is less of a pressing issue, than an invitation for an open collection of ideas about future CLI design :)
P.S.: I hope, creating a number of issues is not considered rude - it surely isn't intended that way.
The text was updated successfully, but these errors were encountered: