Skip to content

fix: add Long descriptions and fix stale command name in docs examples#47

Merged
omkar-foss merged 2 commits into
chaoss:mainfrom
GautamKumarOffical:fix/add-cli-help-text
Jun 20, 2026
Merged

fix: add Long descriptions and fix stale command name in docs examples#47
omkar-foss merged 2 commits into
chaoss:mainfrom
GautamKumarOffical:fix/add-cli-help-text

Conversation

@GautamKumarOffical

Copy link
Copy Markdown
Contributor

Fixes #46

Added Long descriptions to all four commands so that disclosure --help provides useful context instead of just the one-liner Short text.

Changes:

  • Root command: added description of what the tool does and exit code semantics
  • scan: added explanation of what it checks (emails, trailers, notes, message patterns)
  • text: added explanation of what it scans and typical use cases (PR descriptions, comments)
  • docs: added brief Long description
  • Fixed stale ai-detection-action references in the docs command examples → now correctly says disclosure

@MoralCode MoralCode left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks for the contribution!

Apologies for asking you to fix things that were present in the original code, but i left a comment about how "Ai contribution detection" isnt the most accurate description of this project. Could you update your docs to clarify that we detect the disclosure of AI use, not the actual AI use itself?

Also can you make sure to signoff on your commit? (the contributing.md in chaoss/collectoss has some docs on how to do this if that helps)

Comment thread cmd/cmd.go Outdated
GautamKumarOffical pushed a commit to GautamKumarOffical/disclosure that referenced this pull request Jun 16, 2026
…I use

Updated Long descriptions for root, scan, and text commands to clarify
that the tool detects signs that AI tool use was disclosed in
contributions, not whether AI was actually used. This addresses
maintainer feedback on PR chaoss#47.

Signed-off-by: Gautam Kumar <gautamkumarofficial@users.noreply.github.com>
@GautamKumarOffical

Copy link
Copy Markdown
Contributor Author

Hey, updated the docs to clarify we detect disclosure of AI use, not the use itself. Also added signoff to the commit. Let me know if anything else needs changing.

@GautamKumarOffical

This comment was marked as spam.

GautamKumarOffical pushed a commit to GautamKumarOffical/disclosure that referenced this pull request Jun 17, 2026
…I use

Updated Long descriptions for root, scan, and text commands to clarify
that the tool detects signs that AI tool use was disclosed in
contributions, not whether AI was actually used. This addresses
maintainer feedback on PR chaoss#47.

Signed-off-by: Gautam Kumar <gautamkumarofficial@users.noreply.github.com>
@GautamKumarOffical

Copy link
Copy Markdown
Contributor Author

Added Signed-off-by to both commits. Please re-review.

@GautamKumarOffical

This comment was marked as spam.

@GautamKumarOffical

This comment was marked as spam.

@MoralCode MoralCode left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The contents of this PR look good to me!

@MoralCode

Copy link
Copy Markdown
Contributor

@GautamKumarOffical in future, please avoid spamming PRs with followups every 2 hours. Asking more times is not likely to get your PR merged faster.

If you want to get PRs merged faster, the real secret is to join the community to building trust and talking to the humans behind the project. This will put you in a position to be able to work on tasks that are high priority for the maintainers and likely to be reviewed faster.

CHAOSS Slack in the #data-ai-detection-action channel is the place to interact with the other maintainers/contributors to this project if youd like to give it a try

@omkar-foss omkar-foss left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi, could you please update this PR as per these details? Thanks.

@GautamKumarOffical

Copy link
Copy Markdown
Contributor Author

Updated with CLI help text as requested in #46. Added Long descriptions to root, scan, and text commands with usage examples. Please re-review.

@omkar-foss

Copy link
Copy Markdown
Contributor

Updated with CLI help text as requested in #46. Added Long descriptions to root, scan, and text commands with usage examples. Please re-review.

Command descriptions are looking fine. But there don't seem to be any usage examples added for scan, text and version right now. Could you please check that? I think once those examples are added, this PR should be ready to merge.

Adds Long descriptions to root, scan, and text commands providing
usage examples and detailed explanations of what each command does.

Closes chaoss#46

Signed-off-by: Gautam Kumar <gautamkumarofficial@users.noreply.github.com>
@GautamKumarOffical

Copy link
Copy Markdown
Contributor Author

Added usage examples for scan, text, and version commands using cobra's Example field. Examples now show in --help output. Please re-review.

@GautamKumarOffical

This comment was marked as spam.

…e name

Signed-off-by: Gautam Kumar <gautamkumarofficial@users.noreply.github.com>

@omkar-foss omkar-foss left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

PR looks fine, merging it.

Just one problem in examples here, disclosure version doesn't have a --format flag right now so if someone tries these examples it'll break. But I'll check this out in a separate issue.

@omkar-foss omkar-foss merged commit dfe5a3c into chaoss:main Jun 20, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

add description/help text to the CLI

3 participants