From 03fcc3616f8484b4a28f72289fa575da27d973af Mon Sep 17 00:00:00 2001 From: Yi Lin Date: Sat, 31 Oct 2026 23:47:20 +0000 Subject: [PATCH 1/3] Add a doc about AI policy --- CONTRIBUTING.md | 4 ++++ docs/contribute/ai_policy.md | 24 ++++++++++++++++++++++++ 2 files changed, 28 insertions(+) create mode 100644 docs/contribute/ai_policy.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index dbaa67c4823..d2415628c9c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,3 +16,7 @@ Generally we expect a pull request to meeting the following requirements before 3. The PR does not introduce unsafe Rust code unless necessary. Whenever introducing unsafe code, the contributor must elaborate why it is necessary. 4. The PR passes the mmtk-core unit tests and complies with the coding style. We have scripts in `.github/scripts` that are used by our Github action to run those checks for each PR. 5. The PR passes all the binding tests. We run benchmarks with bindings to test mmtk-core. A new pull request should not break bindings, as we ensure that our supported bindings always work with the latest mmtk-core. If a pull request makes changes that require the bindings to be updated correspondingly, you can approach the MMTk team on [our Zulip](https://mmtk.zulipchat.com/) and seek help from them to update the bindings. + +## Using AI tools + +You may use AI tools, such as large language models (LLMs), to help with your contributions. A human must submit the contribution, and is responsible for all of its content. See our [AI policy](docs/contribute/ai_policy.md) for details. diff --git a/docs/contribute/ai_policy.md b/docs/contribute/ai_policy.md new file mode 100644 index 00000000000..77f3ec30cb6 --- /dev/null +++ b/docs/contribute/ai_policy.md @@ -0,0 +1,24 @@ +# AI Policy + +In this policy, a *contribution* is any content that an account submits to MMTk projects, such as +code, documentation, pull requests, issues, and comments. This policy applies to contributions that +include content generated by AI tools, such as large language models (LLMs). + +* **AI-generated content is allowed.** You may use AI tools to help produce your contributions. +* **A human must be behind the account.** You must submit contributions and engage with the + community from your own account, e.g. responding to reviews and discussions. We currently do not + allow fully automated accounts (e.g. accounts operated by AI agents) to make contributions. +* **You are responsible for your contributions.** You are responsible for all the content of your + contributions, regardless of how it was produced. + * **Self-review.** We strongly recommend that you understand your contributions, verify their + facts and review the code before making them public and requesting review from others + ([draft pull requests](../team/code_review.md#draft-pull-requests) are exceptions as they are + normally not reviewed). + * **Disclosure is optional.** You may indicate AI use (e.g. a `Co-authored-by` or `Assisted-by` + commit trailer, or a note in the pull request) to help reviewers. +* **Licensing.** You must ensure that your contributions can be distributed under MMTk's license + (see [COPYRIGHT](../../COPYRIGHT)), and that they do not include content from sources with + incompatible licenses. +* **We review the content, not the tool.** Contributions are reviewed based on their content and + quality, not on whether AI was used. However, low-quality or careless contributions may result in + lower priority when reviewing future contributions from the same account. From 61e2f693f15b0ea153e0b4f6f5fdf334d0695a61 Mon Sep 17 00:00:00 2001 From: Yi Lin Date: Sun, 1 Nov 2026 00:23:07 +0000 Subject: [PATCH 2/3] Require self-review --- CONTRIBUTING.md | 2 +- docs/contribute/ai_policy.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d2415628c9c..9ffe3c9d2f9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,4 +19,4 @@ Generally we expect a pull request to meeting the following requirements before ## Using AI tools -You may use AI tools, such as large language models (LLMs), to help with your contributions. A human must submit the contribution, and is responsible for all of its content. See our [AI policy](docs/contribute/ai_policy.md) for details. +You may use AI tools, such as large language models (LLMs), to help with your contributions. A human must submit the contribution, review it, and is responsible for all of its content. See our [AI policy](docs/contribute/ai_policy.md) for details. diff --git a/docs/contribute/ai_policy.md b/docs/contribute/ai_policy.md index 77f3ec30cb6..9f126470a7a 100644 --- a/docs/contribute/ai_policy.md +++ b/docs/contribute/ai_policy.md @@ -10,8 +10,8 @@ include content generated by AI tools, such as large language models (LLMs). allow fully automated accounts (e.g. accounts operated by AI agents) to make contributions. * **You are responsible for your contributions.** You are responsible for all the content of your contributions, regardless of how it was produced. - * **Self-review.** We strongly recommend that you understand your contributions, verify their - facts and review the code before making them public and requesting review from others + * **Self-review is required.** You must make your best effort to understand your contributions, + verify their facts and review the code before making them public and requesting review from others ([draft pull requests](../team/code_review.md#draft-pull-requests) are exceptions as they are normally not reviewed). * **Disclosure is optional.** You may indicate AI use (e.g. a `Co-authored-by` or `Assisted-by` From 085fdfcb5662443495f85843a9c3e17b68caa26f Mon Sep 17 00:00:00 2001 From: Yi Lin Date: Mon, 2 Nov 2026 02:58:40 +0000 Subject: [PATCH 3/3] Expect self-review instead of requiring it. Mention raw AI output. --- CONTRIBUTING.md | 2 +- docs/contribute/ai_policy.md | 13 +++++++------ 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9ffe3c9d2f9..34e35bbab02 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,4 +19,4 @@ Generally we expect a pull request to meeting the following requirements before ## Using AI tools -You may use AI tools, such as large language models (LLMs), to help with your contributions. A human must submit the contribution, review it, and is responsible for all of its content. See our [AI policy](docs/contribute/ai_policy.md) for details. +You may responsibly use AI tools, such as large language models (LLMs), to help with your contributions. Contributions must be submitted by a human, who is responsible for all of their content. See our [AI policy](docs/contribute/ai_policy.md) for details. diff --git a/docs/contribute/ai_policy.md b/docs/contribute/ai_policy.md index 9f126470a7a..2e901112202 100644 --- a/docs/contribute/ai_policy.md +++ b/docs/contribute/ai_policy.md @@ -6,14 +6,15 @@ include content generated by AI tools, such as large language models (LLMs). * **AI-generated content is allowed.** You may use AI tools to help produce your contributions. * **A human must be behind the account.** You must submit contributions and engage with the - community from your own account, e.g. responding to reviews and discussions. We currently do not - allow fully automated accounts (e.g. accounts operated by AI agents) to make contributions. + community from your own account. We currently do not allow fully automated accounts (e.g. + accounts operated by AI agents) to make contributions. * **You are responsible for your contributions.** You are responsible for all the content of your contributions, regardless of how it was produced. - * **Self-review is required.** You must make your best effort to understand your contributions, - verify their facts and review the code before making them public and requesting review from others - ([draft pull requests](../team/code_review.md#draft-pull-requests) are exceptions as they are - normally not reviewed). + * **Self-review is expected.** Raw AI output is rarely good enough for others to review, and we + expect you to self-review and iterate on it. You should make your best effort to understand + your contributions, verify their facts and improve them before making them public and + requesting review from others ([draft pull requests](../team/code_review.md#draft-pull-requests) + are exceptions as they are normally not reviewed). * **Disclosure is optional.** You may indicate AI use (e.g. a `Co-authored-by` or `Assisted-by` commit trailer, or a note in the pull request) to help reviewers. * **Licensing.** You must ensure that your contributions can be distributed under MMTk's license