This is an automated email from the ASF dual-hosted git repository.
thisisnic pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow.git
The following commit(s) were added to refs/heads/main by this push:
new 4e04d46c4e GH-49275: [Doc] Update docs to specify disclosure of AI on
mailing list messages (#49277)
4e04d46c4e is described below
commit 4e04d46c4ebb54d5e4e06ada1b9a0e59c4287930
Author: Nic Crane <[email protected]>
AuthorDate: Wed May 27 14:46:19 2026 +0100
GH-49275: [Doc] Update docs to specify disclosure of AI on mailing list
messages (#49277)
### Rationale for this change
Replying to AI on the mailing list is annoying
### What changes are included in this PR?
Specify people should disclose
### Are these changes tested?
Nah
### Are there any user-facing changes?
Just docs
* GitHub Issue: #49275
Authored-by: Nic Crane <[email protected]>
Signed-off-by: Nic Crane <[email protected]>
---
CONTRIBUTING.md | 5 +++++
README.md | 4 ++++
docs/source/developers/guide/communication.rst | 5 +++++
docs/source/developers/overview.rst | 1 +
4 files changed, 15 insertions(+)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index dc7d7a2244..f23c18f326 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -64,6 +64,11 @@ publicly on the [arrow-dev
mailing-list](https://mail-archives.apache.org/mod_mb
You can also ask on the mailing-list, see above.
+## Are you using AI coding tools?
+
+Please review our [AI-generated code
guidance](https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code)
+before submitting AI-assisted contributions.
+
## Further information
Please read our [development
documentation](https://arrow.apache.org/docs/developers/index.html)
diff --git a/README.md b/README.md
index 3f778ce6b8..7ba3f56fce 100644
--- a/README.md
+++ b/README.md
@@ -91,6 +91,9 @@ on git main.
Please read our latest [project contribution guide][4].
+If you are using AI coding tools, please review our
+[AI-generated code guidance][7].
+
## Getting involved
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.
[4]: https://arrow.apache.org/docs/dev/developers/index.html
[5]: https://runs-on.com/
[6]: https://aws.amazon.com/
+[7]:
https://arrow.apache.org/docs/dev/developers/overview.html#ai-generated-code
diff --git a/docs/source/developers/guide/communication.rst
b/docs/source/developers/guide/communication.rst
index e87c64a2fe..c22daeac79 100644
--- a/docs/source/developers/guide/communication.rst
+++ b/docs/source/developers/guide/communication.rst
@@ -119,6 +119,11 @@ It is announced on the development mailing list together
with the link to join.
.. seealso::
More information and links for subscribing to the mailing lists `can be
found here <https://arrow.apache.org/community/>`_.
+.. note::
+ Using AI tools to help with phrasing or grammar is absolutely fine. However,
+ we'd love to hear from *you* rather than your AI assistant - please don't
+ use AI to generate questions or comments on your behalf.
+
Recommended learning resources
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/source/developers/overview.rst
b/docs/source/developers/overview.rst
index 0b3660e4d7..e91d1c28ac 100644
--- a/docs/source/developers/overview.rst
+++ b/docs/source/developers/overview.rst
@@ -179,6 +179,7 @@ the following:
* 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
+* AI agents should never tag or ping maintainers
PR authors are also responsible for disclosing any copyrighted materials in
submitted contributions. See the `ASF's guidance on AI-generated code
