Re: [PATCH v2] docs/devel: relax policy on AI-generated contributions

["Daniel P. Berrangé" <berrange@redhat.com>]

On Fri, Aug 07, 2026 at 01:39:32PM +0100, Peter Maydell wrote:
> On Sun, 2 Aug 2026 at 20:51, Michael S. Tsirkin <mst@redhat.com> wrote:
> > So GCC has now decided that 15 lines or so is ok, if a maintainer
> > decides so, and that one
> > should only count significantly different changes, what they call,
> > following the gnu maintainer guidelines "legally significant contributions":
> >
> >         A change of just a few lines (less than 15 or so) is not legally
> >         significant for copyright. A regular series of repeated changes, such as
> >         renaming a symbol, is not legally significant even if the symbol has to
> >         be renamed in many places.
> 
> That is more that the GNU project already had a level they defined
> as legally significant, because they wanted it to determine whether
> they needed copyright assignment or not. So it's natural for GCC to
> use it also in their AI policy.

None the less that is an interesting benchmark.

A key challenge we've always had in these discussions is how
to draw a line on what "legally signicant" means in practice.

The fact that the GNU project has used the "15 lines" rule
for copyright assignment is quite a useful benchmark to take
in to account precisely because they've used that for years
(presumably decades?). To me the longevity gives it weight
because it isn't something made up recently to suit the needs
of those pushing use AI/LLM tools, and has had long term
practical application in many real world OSS projects.


> > GCC also makes an exception for tests and I guess we could make
> > an exception for internal developer docs?
>
> I don't think we should have AI generated docs, including
> developer docs, as I noted somewhere up thread. That's not for
> any particular copyright reasons, it's because we need actual
> humans to be understanding and writing the documentation,
> because it can't be easily cross-checked by tests.

IME, it is by writing docs for a feature, that you come to learn about
the flaws / gaps in the thing that is implemented, which feeds back to
improve the code.  Generating docs you're just going get text that
reflects the state of the code without the learning & improvement
experiance.

I don't think we should have an exception for tests either. If we
have code in the tests directory that is generalized to become
part of the broader codebase, we shouldn't have to think about the
history of whether the tests code was AI generated.

The boundary between docs and code is also not entirely clear cut
and intermingled in areas like command line help, QAPI inline
docs, API doc comments,and so on.

IMHO all content in the repository should be treated the equivalently
and held to a common standard. IOW, *if* we decide it is reasonable to
allow limited AI/LLM usage in some manner, prefer to do that universally
rather than trying to be very selective across sub-directories/files.

Simplicity & clarity of rules makes it more likely that people will
actually be able to follow them.

With regards,
Daniel
-- 
|: https://berrange.com       ~~        https://hachyderm.io/@berrange :|
|: https://libvirt.org          ~~          https://entangle-photo.org :|
|: https://pixelfed.art/berrange   ~~    https://fstop138.berrange.com :|