Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better rendering for a single command with lots of subcommands #110

Open
tsibley opened this issue May 28, 2019 · 0 comments
Open

Better rendering for a single command with lots of subcommands #110

tsibley opened this issue May 28, 2019 · 0 comments

Comments

@tsibley
Copy link

tsibley commented May 28, 2019

A common CLI pattern is to have a single top-level command with lots of subcommands (e.g. git, docker). Currently that renders a heading/TOC tree like this (using git as an example):

git
  Sub-commands:
    init
    clone
    checkout
    …

This adds what feels like an unnecessary level of nesting due to the presence of the Sub-commands heading. It would be nice to be able to suppress this, at least for the top-level command/parser, e.g.:

git
  init
  clone
  checkout
  …

or even flatten/splat them entirely as:

init
clone
checkout
…

without having to give up auto-generation of subcommands and explicitly name init, clone, checkout, … in the RST document.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant