Skip to content

CONTRIBUTING.md: clarify AI usage in commit trailers - #166

Merged
fuweid merged 1 commit into
containerd:mainfrom
fuweid:update-contribute
Aug 6, 2026
Merged

CONTRIBUTING.md: clarify AI usage in commit trailers#166
fuweid merged 1 commit into
containerd:mainfrom
fuweid:update-contribute

Conversation

@fuweid

@fuweid fuweid commented Jun 4, 2026

Copy link
Copy Markdown
Member

Comment thread CONTRIBUTING.md

Use your real name (sorry, no pseudonyms or anonymous contributions.)

AI tools, services, or assistants may be used to assist with contributions, but

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Co-authored-by: AI seems fine as long as Signed-off-by is added by a human?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

It's hard to tell that during review 😂. Contributor can add them in description

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'd like us to encourage an Assisted-by trailer. I think that's better than Co-authored-by and better than just adding into the PR description.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

FYI k8s community forbids AI co-authored-by/assisted-by etc.
https://github.com/kubernetes/community/blob/main/contributors/guide/pull-requests.md#ai-guidance
"Listing AI tooling as a co-author, co-signing commits using an AI tool, or using the assisted-by, co-developed or similar commit trailer is not allowed.":

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

It does. I disagree with that conclusion and it is not a CNCF-wide policy so we are not bound by it.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I also disagree with that conclusion.

CNCF is our parent foundation, yes. However kubernetes arguably being it's biggest project, I figured it needed referencing, for completion, here in this PR.

Made the argument for assisted by at kubecon/cncf con when this was presented on maintainer day. Response was no AI signatures of any kind in the commit message, but you can state assisted by, etc, in the PR.

Also recognizing that this allowance of the assisted-by AI commit trailer, is not a MUST. So I've been using PR text for that.

Also avoiding extra end of file AI assisted comments in code.

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
@fuweid
fuweid force-pushed the update-contribute branch from 2cd470a to 660851f Compare June 4, 2026 17:25
@fuweid fuweid changed the title CONTRIBUTING.md: clarify AI usage in contribution trailers CONTRIBUTING.md: clarify AI usage in commit trailers Jun 4, 2026
@fuweid

fuweid commented Jun 12, 2026

Copy link
Copy Markdown
Member Author

ping @containerd/committers

Comment thread CONTRIBUTING.md
Use your real name (sorry, no pseudonyms or anonymous contributions.)

AI tools, services, or assistants may be used to assist with contributions, but
do not add them to `Signed-off-by` or `Co-authored-by` lines. These commit

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can we add Co-Authored-By: Claude * <noreply@anthropic.com> to the allowlist?
Too useful to reject by default.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

The Change is to avoid them. So, I would like to say no

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The purpose of the human authored by records is for humans to agree to the apache2 license for the commit diff, and we're not supposed to allow anonymous.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The purpose of the human authored by records is for humans to agree to the apache2 license for the commit diff, and we're not supposed to allow anonymous.

Isn't it covered by Signed-off-by: <HUMAN>?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Signed-off-by: <HUMAN> covers the certification. To me, Co-authored-by usually represents another human author, and I don't think an AI tool should be treated as a co-author there. If it does, we probably can add vim/awk/sed tool as co-author too. It doesn't make senses to me

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this ^.. while I understand the reporting honesty of co-authored by attribution to a tool... The co-authored by is bound, legally, to the license requirement, warrant that the code is theirs etc.. not copied from a GPL license.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The co-authored by is bound, legally, to the license requirement

I don't believe any of us are lawyers. If you are concerned about this from a legal perspective, I think we can ask CNCF for their advice. But I don't expect the co-authored-by trailer has any specific weight in a dispute (at least in the context of the US), especially if it's a known LLM tool rather than a human.

@fuweid
fuweid force-pushed the update-contribute branch from 660851f to b7f0d11 Compare June 26, 2026 16:03
Signed-off-by: Wei Fu <fuweid89@gmail.com>
@fuweid
fuweid force-pushed the update-contribute branch from b7f0d11 to 63315a5 Compare June 26, 2026 22:08

@mikebrow mikebrow left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@fuweid

fuweid commented Jul 16, 2026

Copy link
Copy Markdown
Member Author

kindly ping @dmcgowan @AkihiroSuda @dims @kzys @kiashok any objection?

@dims dims left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@fuweid
fuweid merged commit 08aeb7d into containerd:main Aug 6, 2026
1 check passed
@fuweid
fuweid deleted the update-contribute branch August 6, 2026 17:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants