Skip to content

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

Open
GautamKumarOffical wants to merge 1 commit into
chaoss:mainfrom
GautamKumarOffical:fix/add-cli-help-text
Open

fix: add Long descriptions and fix stale command name in docs examples#47
GautamKumarOffical wants to merge 1 commit into
chaoss:mainfrom
GautamKumarOffical:fix/add-cli-help-text

Conversation

@GautamKumarOffical

Copy link
Copy Markdown

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
Comment on lines +47 to +48
Short: "Detect AI-generated contributions",
Long: `A standalone CLI tool that detects AI-generated contributions in git

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.

detecting ai contributions isnt the most accurate description. this project is intended to detect disclosures of AI contributions. We aren't in the business of detecting AI use when people are trying to hide that they are using AI.

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
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

Copy link
Copy Markdown
Author

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

…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
Author

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

@GautamKumarOffical

Copy link
Copy Markdown
Author

The docs have been updated to clarify that we detect disclosure of AI use, not actual AI use. Signoff is also included. Please re-review.

@GautamKumarOffical

Copy link
Copy Markdown
Author

Updated with signoff and docs clarification. Please re-review when you get a chance.

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

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

add description/help text to the CLI

2 participants