Skip to content

📖 Improve CLI help with quick start examples#4995

Closed
sachin9058 wants to merge 1 commit intoossf:mainfrom
sachin9058:improve-cli-help
Closed

📖 Improve CLI help with quick start examples#4995
sachin9058 wants to merge 1 commit intoossf:mainfrom
sachin9058:improve-cli-help

Conversation

@sachin9058
Copy link
Copy Markdown

@sachin9058 sachin9058 commented Apr 1, 2026

What kind of change does this PR introduce?

This PR introduces a documentation/UX improvement by enhancing the CLI help output.

  • PR title follows the guidelines defined in our pull request documentation

What is the current behavior?

The CLI help output provides basic usage information but lacks clear examples and quick-start guidance, which can make it less intuitive for new users.

What is the new behavior (if this is a feature change)?

The CLI help output is improved by:

  • Adding a Quick Start section with a simple usage example

  • Providing a concrete example using a real repository

  • Adding a note clarifying required input flags

  • Improving overall readability and usability for beginners

  • Tests for the changes have been added (not applicable as this is a documentation/UX improvement)

Which issue(s) this PR fixes

NONE

Special notes for your reviewer

This change only updates the CLI help text (scorecardLong and usage description) and does not modify any core functionality.

Does this PR introduce a user-facing change?

Yes

Improved CLI help output by adding quick start examples and clearer usage instructions.

@sachin9058 sachin9058 requested a review from a team as a code owner April 1, 2026 17:12
@sachin9058 sachin9058 requested review from AdamKorcz and spencerschrock and removed request for a team April 1, 2026 17:12
@dosubot dosubot Bot added the size:S This PR changes 10-29 lines, ignoring generated files. label Apr 1, 2026
Signed-off-by: Sachin Kumar <sachinkumar905846@gmail.com>
@sachin9058
Copy link
Copy Markdown
Author

Hi, I have updated the PR and resolved the DCO issue. Please let me know if any further changes are needed.

@sachin9058 sachin9058 changed the title Improve CLI help with quick start examples and clearer usage 📖 Improve CLI help with quick start examples Apr 1, 2026
@github-actions
Copy link
Copy Markdown

This pull request has been marked stale because it has been open for 10 days with no activity

@github-actions github-actions Bot added the Stale label Apr 17, 2026
@spencerschrock
Copy link
Copy Markdown
Member

Thanks for the contribution, but there are examples in the README, and I don't feel they should belong in the CLI usage string.

Plus scorecard github.com/ossf/scorecard isn't valid syntax.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:S This PR changes 10-29 lines, ignoring generated files. Stale

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants