Skip to content

GH-49275: [Doc] Update docs to specify disclosure of AI on mailing list messages#49277

Open
thisisnic wants to merge 3 commits into
apache:mainfrom
thisisnic:GH-49275_BOTS
Open

GH-49275: [Doc] Update docs to specify disclosure of AI on mailing list messages#49277
thisisnic wants to merge 3 commits into
apache:mainfrom
thisisnic:GH-49275_BOTS

Conversation

@thisisnic
Copy link
Copy Markdown
Member

@thisisnic thisisnic commented Feb 13, 2026 •
edited by github-actions Bot
Loading

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-actions
Copy link
Copy Markdown

github-actions Bot commented Feb 13, 2026

⚠️ GitHub issue #49275 has been automatically assigned in GitHub to PR creator.

@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented Feb 13, 2026

@rok I had 2 options which seemed different levels of reasonable:

I got two options that seem reasonable:

A.

Using AI tools to help with phrasing or grammar is fine. However, please don't use AI to generate questions on your behalf - we want to help you, not your AI assistant.

B.

Using AI tools to help with phrasing or grammar is fine and doesn't need to be disclosed. However, if AI is more involved in your workflow (e.g. generating questions or diagnosing errors), please let us know so we can tailor our responses appropriately.

What do you think? Could go with something else entirely.

@rok
Copy link
Copy Markdown
Member

rok commented Feb 13, 2026

Option A seems beter for the explicitness. In a "no unattended" agents kinda way

@thisisnic thisisnic marked this pull request as ready for review February 13, 2026 15:55
@thisisnic thisisnic requested review from pitrou and raulcd February 13, 2026 15:56
@rok
Copy link
Copy Markdown
Member

rok commented Feb 13, 2026

I suppose the thinking is that we cannot hope to communicate to unattended agents simply for our communication bandwidth not being scalable.

thisisnic
thisisnic commented Feb 13, 2026
View reviewed changes
Comment thread docs/source/developers/guide/communication.rst Outdated
@github-actions github-actions Bot added awaiting changes Awaiting changes and removed awaiting committer review Awaiting committer review labels Feb 13, 2026
@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented Feb 13, 2026

I suppose the thinking is that we cannot hope to communicate to unattended agents simply for our communication bandwidth not being scalable.

Yeah, I think "just a few is fine" sounds reasonable with the current volume, but looking at the recent shenanigans with matplotlib, this feels like it could get out of control very easily. And it's not hard to say "I was working on this PR and the AI tool wanted me to check the following - can you clarify which of those approaches is best?" or something.

@thisisnic thisisnic requested a review from rok March 5, 2026 10:51
@github-actions github-actions Bot added awaiting change review Awaiting change review and removed awaiting changes Awaiting changes labels May 19, 2026
@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented May 19, 2026

@AlenkaF and @raulcd - I folded in a few bits and pieces from our earlier chat here, mind giving this a review?

AlenkaF
AlenkaF approved these changes May 19, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@AlenkaF AlenkaF left a comment

Choose a reason for hiding this comment

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

Looks great, thanks for this!

Comment thread docs/source/developers/guide/communication.rst
.. seealso::
More information and links for subscribing to the mailing lists `can be found here <https://arrow.apache.org/community/>`_.

.. note::
Copy link
Copy Markdown
Member

@AlenkaF AlenkaF May 19, 2026

Choose a reason for hiding this comment

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

Nice 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@AlenkaF AlenkaF AlenkaF approved these changes

@raulcd raulcd Awaiting requested review from raulcd

@pitrou pitrou Awaiting requested review from pitrou

@rok rok Awaiting requested review from rok

Assignees

No one assigned

Labels

awaiting change review Awaiting change review Component: Documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@thisisnic @rok @AlenkaF