Skip to content

governance: Add AI/LLM contribution policy - #10057

Open
jennings wants to merge 1 commit into
mainfrom
jennings/vppnrsszpmpz
Open

governance: Add AI/LLM contribution policy#10057
jennings wants to merge 1 commit into
mainfrom
jennings/vppnrsszpmpz

Conversation

@jennings

Copy link
Copy Markdown
Contributor

Checklist

If applicable:

  • I have updated CHANGELOG.md
  • I have updated the documentation (README.md, docs/, demos/)
  • I have updated the config schema (cli/src/config-schema.json)
  • I have added/updated tests to cover my changes
  • I fully understand the code that I am submitting (what it does,
    how it works, how it's organized), including any code drafted by an LLM.
  • For any prose generated by an LLM, I have proof-read and copy-edited with
    an eye towards deleting anything that is irrelevant, clarifying anything
    that is confusing, and adding details that are relevant. This includes,
    for example, commit descriptions, PR descriptions, and code comments.

@jennings
jennings requested a review from a team as a code owner August 25, 2026 16:38
@jennings
jennings force-pushed the jennings/vppnrsszpmpz branch 2 times, most recently from 1abfe94 to 696cd97 Compare August 25, 2026 16:41

@PhilipMetzger PhilipMetzger 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.

minor comment, also this should mention the AI policy issue

Comment thread docs/contributing.md Outdated

@nasamuffin nasamuffin 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.

I agree with the overall thrust of the policy. Had a couple phrasing nits here and there.

Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md Outdated
@josephlou5

Copy link
Copy Markdown
Contributor

also this should mention the AI policy issue

#9219 I think?

@scott2000 scott2000 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.

This looks great, thanks for doing this!

@PhilipMetzger PhilipMetzger 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.

This is a good start but imo incomplete.

Comment thread docs/contributing.md

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.

nit: I think this should be here and in a separate document, something like AI_POLICY which we then also add to the website.

Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md Outdated
Comment thread docs/contributing.md
Comment on lines +48 to 49

### Commit guidelines

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.

nit: This has currently no teeth, since it doesn't provide a way for the project to react to this beside commenting. If we want to have this as a policy there should be a way for core contributors and maintainers to effectively ban or close PRs which don't conform to this.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm glad to consider other opinions, but I made a conscious choice to omit that for now, because:

  • I don't think anything's stopping us from closing a PR even if we don't mention that here.
  • If we do close a PR citing the policy, the author saying, "But the policy doesn't say you'll close the PR" seems a pretty weak counter-argument to me.
  • We're pretty low-touch in general, so I'd rather avoid creating an exact process until we need it

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.

I'm glad to consider other opinions, but I made a conscious choice to omit that for now, because:

  • I don't think anything's stopping us from closing a PR even if we don't mention that here.
  • If we do close a PR citing the policy, the author saying, "But the policy doesn't say you'll close the PR" seems a pretty weak counter-argument to me.
  • We're pretty low-touch in general, so I'd rather avoid creating an exact process until we need it

In my opinion, a policy like this is not written against the current state of the project (and the still low-touch sentiment people have), its written for the future and any issue which comes along from the AI direction and for that we should empower people we trust to do the right thing.

I would like you to trust me on this since I the last few policies were written from me and that at a large personal cost.

  • If we do close a PR citing the policy, the author saying, "But the policy doesn't say you'll close the PR" seems a pretty weak counter-argument to me.

And that's how you shouldn't do it (as in explicitly writing "we're going to close PRs and hide comments etc..."), but just encoding the right to act on it.

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.

Stephens reasoning makes sense to me. If experience shows that enforcement isn't working, the policy can be adjusted.

I would like you to trust me on this since I the last few policies were written from me and that at a large personal cost.

"Trust me" isn't an argument. Decisions in open-source aren't made based on authority. And what's with the comment about personal cost? I can't see how that's relevant to the topic at hand.

@jennings
jennings force-pushed the jennings/vppnrsszpmpz branch from 696cd97 to 53753b2 Compare August 26, 2026 16:04
@PhilipMetzger

Copy link
Copy Markdown
Contributor

Also minor topic quibble, while this is a action of the "governance", it doesn't change GOVERNANCE.md so the governance: topic is pretty wrong. If anything this is a project-wide or meta-decision, so project: or meta: is more appropriate.

The goals of this policy are:

- Require disclosure of AI use
- Allow the use of AI for contribution
- Disallow the use AI for communication

This policy is modeled after similar permissive policies in other open
source projects, such as [Ghostty], [LLVM], and [Rust]. We should start
with a minimal policy and only expand it when it seems necessary.

[Ghostty]: https://github.com/ghostty-org/ghostty/blob/main/AI_POLICY.md
[LLVM]: https://llvm.org/docs/AIToolPolicy.html
[Rust]: https://forge.rust-lang.org/policies/llm-usage.html
@jennings
jennings force-pushed the jennings/vppnrsszpmpz branch from 53753b2 to 3f77394 Compare August 26, 2026 16:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants