From d959d3c704a842d6f31e5f4268b145ef5f73c552 Mon Sep 17 00:00:00 2001 From: Ed Seidl Date: Mon, 4 May 2026 13:23:22 -0700 Subject: [PATCH 1/4] add expectations for AI submissions --- CONTRIBUTING.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 83ee468c32e5..a74f28d0c0bb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -256,3 +256,20 @@ If sometimes you want to commit without checking, just run `git commit` with `-- ```bash git commit --no-verify -m "... commit message ..." ``` + +## AI Generated Submissions + +This project follows the guidance for AI generated submissions used by the +[Arrow Project](https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code). +As such, it is expected that you will: +- Only submit a PR if you are able to debug and own the changes yourself - review all generated +code to understand every detail +- Match the style and conventions used in the rest of the codebase, including PR titles and descriptions +- Be upfront about AI usage and summarise what was AI-generated +- If there are parts you don’t fully understand, leave comments on your own PR explaining what steps you took to verify correctness +- Watch for AI’s tendency to generate overly verbose comments, unnecessary test cases, and incorrect fixes +- Break down large PRs into smaller ones to make review easier + +It is also important for submitters to be aware of potential copyright issues. See the ASF's +[guidance](https://www.apache.org/legal/generative-tooling.html) on AI-generated code for further +information on licensing considerations. \ No newline at end of file From bf5349fdf2969f8ef95056f3c31ecfd86b6079bf Mon Sep 17 00:00:00 2001 From: Ed Seidl Date: Mon, 4 May 2026 13:44:54 -0700 Subject: [PATCH 2/4] formatting --- CONTRIBUTING.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a74f28d0c0bb..cb5a61f4bd65 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -262,8 +262,9 @@ git commit --no-verify -m "... commit message ..." This project follows the guidance for AI generated submissions used by the [Arrow Project](https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code). As such, it is expected that you will: + - Only submit a PR if you are able to debug and own the changes yourself - review all generated -code to understand every detail + code to understand every detail - Match the style and conventions used in the rest of the codebase, including PR titles and descriptions - Be upfront about AI usage and summarise what was AI-generated - If there are parts you don’t fully understand, leave comments on your own PR explaining what steps you took to verify correctness From 56a14ce0b8b3101a8f064f0686a7ef7c1dd1da32 Mon Sep 17 00:00:00 2001 From: Ed Seidl Date: Mon, 4 May 2026 13:46:44 -0700 Subject: [PATCH 3/4] whitespace --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index cb5a61f4bd65..d08cc3c7fadd 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -263,7 +263,7 @@ This project follows the guidance for AI generated submissions used by the [Arrow Project](https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code). As such, it is expected that you will: -- Only submit a PR if you are able to debug and own the changes yourself - review all generated +- Only submit a PR if you are able to debug and own the changes yourself - review all generated code to understand every detail - Match the style and conventions used in the rest of the codebase, including PR titles and descriptions - Be upfront about AI usage and summarise what was AI-generated From 55a18753ae180c1f3a534fe333c183f2b132eab4 Mon Sep 17 00:00:00 2001 From: Ed Seidl Date: Mon, 4 May 2026 13:49:14 -0700 Subject: [PATCH 4/4] try again --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d08cc3c7fadd..48075c5ef771 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -273,4 +273,4 @@ As such, it is expected that you will: It is also important for submitters to be aware of potential copyright issues. See the ASF's [guidance](https://www.apache.org/legal/generative-tooling.html) on AI-generated code for further -information on licensing considerations. \ No newline at end of file +information on licensing considerations.