Skip to content

docs: improve CLI help text with detailed descriptions and examples#37

Merged
azu merged 1 commit intomainfrom
docs/improve-cli-help-text
Apr 4, 2026
Merged

docs: improve CLI help text with detailed descriptions and examples#37
azu merged 1 commit intomainfrom
docs/improve-cli-help-text

Conversation

@azu
Copy link
Copy Markdown
Owner

@azu azu commented Apr 4, 2026

Summary

Improve the CLI help text for the check, run, and root commands by adding detailed long descriptions, status code explanations, and usage examples.

Changes

  • Add comprehensive Long descriptions to checkCmd, runCmd, and rootCmd explaining supported file types, detection behavior, configuration, and authentication
  • Add Example fields with practical usage patterns (dry-run, write, glob, JSON output, ignore patterns)
  • Document status codes (OK, FAIL, SKIP, WARN) for the check command
  • Document skip behavior (scratch, multi-stage, ARG-only, build directive, etc.) for the run command

Breaking Changes

None

Test Plan

  • Run dockerfile-pin --help, dockerfile-pin run --help, dockerfile-pin check --help and verify the output is well-formatted
  • Verify no functional changes by running go build and existing tests

Add comprehensive long descriptions and usage examples to the check,
run, and root commands for better discoverability of features.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

@azu azu merged commit d962337 into main Apr 4, 2026
3 checks passed
@azu azu deleted the docs/improve-cli-help-text branch April 4, 2026 01:37
@github-actions github-actions Bot mentioned this pull request Apr 4, 2026
azu pushed a commit that referenced this pull request Apr 4, 2026
<!-- Release notes generated using configuration in .github/release.yml
at main -->

## What's Changed
### Documentation
* docs: Revise installation instructions for clarity by @azu in
#36
* docs: improve CLI help text with detailed descriptions and examples by
@azu in #37
### CI
* ci: Use release PR body as GitHub Release notes by @azu in
#35
* CI: update GitHub Actions dependencies to latest versions by @azu in
#34


**Full Changelog**:
v1.2.0...v1.2.1

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
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

Successfully merging this pull request may close these issues.

1 participant