Skip to content

Reduce AI smell in public docs, issues, and release notes #17

@Akotz89

Description

@Akotz89

Problem

Some public-facing text reads like chat-derived AI output: broad claims, explanatory overreach, dramatic phrasing, and implementation storytelling that may distract from trust in the tool.

Acceptance criteria

  • Review README, CHANGELOG, issue templates, release notes, and SECURITY.md for AI-sounding phrasing.
  • Replace exaggerated or narrative language with concise operator-facing statements.
  • Keep the AI-agent use case because it is core to the project, but avoid visible "AI wrote this" texture.
  • Remove stale chat/session references unless they are converted into neutral regression-test context.
  • Ensure the first viewport of the README explains what the tool does, who it is for, and the risk boundary without hype.

Verification

  • Public docs still explain the value proposition clearly.
  • A new reader can distinguish verified behavior from planned behavior.

Metadata

Metadata

Assignees

No one assigned

    Labels

    ai-smellReduce visible AI-generated wording and over-explainingdocumentationImprovements or additions to documentationgithub-hygieneRepository metadata, labels, templates, branch/release hygiene

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions