Puppet CLI Design

puppet cert

Currently:

puppet cert --list
puppet cert --list --all

Perhaps instead:

puppet cert list
puppet cert list --all

Help and documentation

For commands:

puppet --help         # all possible commands
puppet apply --help   # long-form docs for `apply`

For types:

puppet doc --reference type   # long-form docs for every type
puppet describe file          # long-form docs for file type
puppet describe -s file       # short docs for file type