Skip to content

docs(ai-policy): allow AI-drafted text written for human readers - #839

Merged
nickvergessen merged 1 commit into
masterfrom
docs/ai-policy-human-readable-text
Nov 17, 2026
Merged

nickvergessen merged 1 commit into
masterfrom
docs/ai-policy-human-readable-text

Conversation

@AndyScherzinger

@AndyScherzinger AndyScherzinger commented Nov 16, 2026 •

Copy link
Copy Markdown
Member

The AI policy requires issues, PR descriptions and review comments to be in the contributor's own words, so agent-drafted text has to be retyped by hand. Following nextcloud/mail#14132, this allows AI-drafted text written for human readers and judges contributions by their result, not by how they were produced.

  • AI-drafted text must be plain, disclosed, and follow the repo's templates. PR descriptions say what problem they solve, what changed, and how to verify it; bug reports state whether the bug was reproduced on a live instance.
  • Maintainers may ask for a rewrite before closing a PR that shows neither understanding nor quality. PRs opened before a policy change are asked to adapt.
  • Every PR that changes runtime behavior is tested on a live instance, with AI help if wanted, but not only by AI.
  • Commit message bodies explain why, not how.
  • The snippet's "never do" list now reads "Don't X. Instead, Y." so smaller models know what to do, and the Assisted-by examples name models that exist.

Co-authored by @MiMoHo, whose #818 is the source of the rewrite and grandfathering rules.

🤖 AI (if applicable)

  • The content of this PR was partly or fully generated using AI

@nextcloud-command nextcloud-command added the AI assisted This PR contains AI-assisted commits label Nov 16, 2026
@AndyScherzinger
AndyScherzinger force-pushed the docs/ai-policy-human-readable-text branch 5 times, most recently from 7a0b739 to 503598e Compare November 17, 2026 12:37
@AndyScherzinger
AndyScherzinger marked this pull request as ready for review November 17, 2026 12:41
@AndyScherzinger
AndyScherzinger force-pushed the docs/ai-policy-human-readable-text branch from 503598e to fb7471d Compare November 17, 2026 15:53
@AndyScherzinger
AndyScherzinger force-pushed the docs/ai-policy-human-readable-text branch 4 times, most recently from 51430a1 to e4142f8 Compare November 17, 2026 18:38
The policy required issues, PR descriptions and review comments to be
in the contributor's own words, so agent-drafted text had to be
retyped by hand. Allow AI-drafted text written for humans and judge the
result: maintainers ask for a rewrite before closing, and PRs opened
before a policy change are asked to adapt rather than closed.

Ask for PR descriptions that answer the reviewer's first questions,
reproducible bug reports, commit messages that explain why, and live
testing for every runtime change. Rewrite the snippet's "never do" list
as "don't X, instead Y" so smaller models can follow it, and replace
example models that are retired or never existed.

Co-authored-by: MiMoHo <37556964+MiMoHo@users.noreply.github.com>
Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
@AndyScherzinger
AndyScherzinger force-pushed the docs/ai-policy-human-readable-text branch from e4142f8 to b4317a2 Compare November 17, 2026 18:38
@nickvergessen
nickvergessen merged commit 71fa031 into master Nov 17, 2026
6 checks passed
@nickvergessen
nickvergessen deleted the docs/ai-policy-human-readable-text branch November 17, 2026 20:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI assisted This PR contains AI-assisted commits

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants