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

Docs or man page? #38

Open
gingerbeardman opened this issue Jul 8, 2024 · 2 comments
Open

Docs or man page? #38

gingerbeardman opened this issue Jul 8, 2024 · 2 comments
Assignees
Labels
enhancement New feature or request

Comments

@gingerbeardman
Copy link

gingerbeardman commented Jul 8, 2024

Is your feature request related to a problem? Please describe.
Since v3 i find it troublesome to remember the command line usage and am forever looking things up

Describe the solution you'd like

  • Docs or man page would be great
  • Even better if it can be generated from the source

Could be one of the following formats

  • man
  • Sphinx (most common for Python projects)
  • HTML (generated from Sphinx, I generated my own for aubio)

Describe alternatives you've considered (if relevant)

Additional context

@gingerbeardman gingerbeardman added the enhancement New feature or request label Jul 8, 2024
@arkrow
Copy link
Owner

arkrow commented Jul 11, 2024

Having a docs page would be great. I've actually looked through several tools previously, but they always had some quirk/annoyance, then unfortunately I got busy and never really continued working on it. Instead, I ended up doing CLI_README.md as a stopgap solution. Due to my use of rich-click for nicer CLI rather than the base click library, either the --help view of each subcommand comes out formatted strangely, and/or the help text includes the rich markup, which would would need post-processing to remove.

That said, I'm still interested in doing proper documentation for the project, so I'll be picking it back up once I can.

@arkrow arkrow self-assigned this Jul 11, 2024
@gingerbeardman
Copy link
Author

Thank you kindly!

For reference, perhaps it will influence your decisions, Dash the docset viewer I use accepts a number of formats: https://kapeli.com/docsets

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

No branches or pull requests

2 participants