Skip to content

Commit fda080d

Browse files
committed
Add a bit more detail about AI usage in general
1 parent 33155bb commit fda080d

3 files changed

Lines changed: 12 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,11 @@ publicly on the [arrow-dev mailing-list](https://mail-archives.apache.org/mod_mb
6464

6565
You can also ask on the mailing-list, see above.
6666

67+
## Are you using AI coding tools?
68+
69+
Please review our [AI-generated code guidance](https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code)
70+
before submitting AI-assisted contributions.
71+
6772
## Further information
6873

6974
Please read our [development documentation](https://arrow.apache.org/docs/developers/index.html)

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,9 @@ on git main.
9191

9292
Please read our latest [project contribution guide][4].
9393

94+
If you are using AI coding tools, please review our
95+
[AI-generated code guidance][7].
96+
9497
## Getting involved
9598

9699
Even if you do not plan to contribute to Apache Arrow itself or Arrow
@@ -114,3 +117,4 @@ We use [AWS][6] for some of the required infrastructure for the project.
114117
[4]: https://arrow.apache.org/docs/dev/developers/index.html
115118
[5]: https://runs-on.com/
116119
[6]: https://aws.amazon.com/
120+
[7]: https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code

docs/source/developers/overview.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,6 +179,9 @@ the following:
179179
* Watch for AI's tendency to generate overly verbose comments, unnecessary
180180
test cases, and incorrect fixes
181181
* Break down large PRs into smaller ones to make review easier
182+
* Avoid pinging maintainers to request reviews; most maintainers have
183+
limited time, and we will review PRs as bandwidth allows. AI agents
184+
should never tag or ping maintainers.
182185

183186
PR authors are also responsible for disclosing any copyrighted materials in
184187
submitted contributions. See the `ASF's guidance on AI-generated code

0 commit comments

Comments
 (0)