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

The --help messages are not detailed enough #172

Open
tonowak opened this issue Nov 6, 2022 · 2 comments
Open

The --help messages are not detailed enough #172

tonowak opened this issue Nov 6, 2022 · 2 comments
Labels
A-docs Area: documentation for the command and lints C-enhancement Category: raise the bar on expectations

Comments

@tonowak
Copy link
Collaborator

tonowak commented Nov 6, 2022

Describe your use case

It is not clear between what cargo-semver-check compares the rustdocs and how it generates them (so it is not clear that the --baseline-version and similar flags are not required). The description of the --package flag doesn't explain that it is useful mainly when dealing with workspaces.

Describe the solution you'd like

The --help messages could explain the use cases of the flags and maybe could briefly explain how cargo-semver-check gets the needed data.

Alternatives, if applicable

No response

Additional Context

No response

@tonowak tonowak added the C-enhancement Category: raise the bar on expectations label Nov 6, 2022
@tonowak
Copy link
Collaborator Author

tonowak commented Nov 6, 2022

Also, is the "check-release" subcommand needed? It seems to be the only subcommand.

@tonowak tonowak added the A-docs Area: documentation for the command and lints label Nov 15, 2022
@tonowak
Copy link
Collaborator Author

tonowak commented Jan 8, 2023

Relevant: #86 (comment)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-docs Area: documentation for the command and lints C-enhancement Category: raise the bar on expectations
Projects
None yet
Development

No branches or pull requests

1 participant