linux-kernel - Re: [PATCH v3] README: restructure with role-based documentation and guidelines

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <202511180848.8A660DDB@keescook>
Date: Tue, 18 Nov 2025 08:49:13 -0800
From: Kees Cook <kees@...nel.org>
To: Jonathan Corbet <corbet@....net>
Cc: Sasha Levin <sashal@...nel.org>, linux-doc@...r.kernel.org,
	josh@...htriplett.org, konstantin@...uxfoundation.org,
	linux-kernel@...r.kernel.org, rostedt@...dmis.org,
	workflows@...r.kernel.org, joe@...ches.com, rdunlap@...radead.org
Subject: Re: [PATCH v3] README: restructure with role-based documentation and
 guidelines

On Tue, Nov 18, 2025 at 09:35:29AM -0700, Jonathan Corbet wrote:
> That said, I have one quibble :)
> 
> > +Examples of Proper Attribution:
> > +
> > +Good examples:
> > +  Assisted-by: AI-Tool:model-version-1.0 coccinelle
> > +  Assisted-by: AI-Assistant:v2.5.0
> > +  Assisted-by: Code-Helper:model-2024-04-09 sparse smatch
> > +  Assisted-by: ML-Agent:version-2024-11
> > +
> > +Bad examples (DO NOT USE):
> > +  Assisted-by: AI                          # Too vague
> > +  Assisted-by: AI-Tool coccinelle git      # Don't list basic tools
> > +  Signed-off-by: AI Assistant <ai@...>     # NEVER - AI cannot sign off
> 
> I don't think this belongs here - we don't have examples of good SOB
> lines - or of anything else.  What this needs, instead, is a link to
> Dave's tools document once that goes in.
> 
> (We also, in truth, do not yet have a consensus on what the attribution
> tags should be, and here isn't the place to try to form one.)

Agreed -- I love the new sections, but we need to drop the Assisted-by
portion until we've had the in-person discussions at Maintainers/LPC.

-Kees

-- 
Kees Cook