Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

discussion: guidelines for AI-assisted contributions

Aperta
#7 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Documentazione
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Ambito
documentation

Direzione di ricerca

Inizia leggendo le policy collegate di Bytecode Alliance, LLVM e Fedora, quindi confronta le posizioni proposte per CONTRIBUTING, AI Policy e AGENTS.md descritte nell’issue. Il lavoro è completato quando il progetto ha concordato l’ambito e le aspettative della policy per codice, documentazione, revisioni, divulgazione, paternità e responsabilità, e sono stati identificati i file di documentazione di destinazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

AI-assisted contributions (code, docs, reviews) are becoming common in our project on either documentation or coding. Right now we don't have any written guidance on this, so contributors have to guess what's expected.

This issue is to discuss what the policy should cover. Some questions need to be discussed:

  • Should PRs note when they are substantially AI-assisted (e.g., a line in the PR description or a Co-Authored-By / Assisted-by trailer)?
  • Regardless of tooling, the contributor submitting a PR is responsible for understanding and testing it. Do we want to state this explicitly in CONTRIBUTING or in AI Policy file?
  • Should reviewers treat AI-assisted PRs any differently, or is our normal review bar sufficient?
  • Does the same guidance apply to code, docs, and issue/PR discussions, or do we only care about code?

My personal leaning on the questions above

  • Any tools are fine, but human-in-the-loop is required. Contributors must read and review all AI-generated code or text themselves before asking others to review it.
  • Disclosure is voluntary but AI must not be listed in Co-authored-by. Only humans can be authors and take on the accountability that comes with authorship.
  • The core principle is preventing "extractive contributions": a contribution should be worth more to the project than the maintainer time it takes to review it. Sending unreviewed LLM output to maintainers extracts their time.
  • Copyright responsibility stays with the contributor: regenerating copyrighted material with an AI tool does not remove the copyright.
  • Same guidance applies to all parts.

We could follow the structure used by the Bytecode Alliance wasmtime:

  • An org-level policy file, AI_TOOL_POLICY.md, lives in their governance repo. For us that would be this community repo.
  • Each active project repo carries a thin AGENTS.md with a few hard rules for AI tools themselves (no auto-opened PRs, no auto-comments/reviews, no AI in Co-authored-by), each pointing back to the org-level policy.

Their policy is itself a lightly adapted copy of the LLVM AI Tool Use Policy, which in turn is based on the Fedora Council's policy on AI-assisted contributions, and all under permissive licenses. We can adapt this and add attribution.

Lingua principale
Nessun dato sulla lingua
Stelle
0
Fork
0
Merge medio
11g 18h
PR unite (30g)
1

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.