From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 97AAC84FA; Tue, 04 Aug 2026 16:49:55 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id 201F184E6; Tue, 04 Aug 2026 16:49:53 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-0.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DMARC_MISSING,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=4.0.1 Received: from fhigh-a1-smtp.messagingengine.com (fhigh-a1-smtp.messagingengine.com [103.168.172.152]) by atuin.qyliss.net (Postfix) with ESMTPS id 2967784E5 for ; Tue, 04 Aug 2026 16:49:51 +0000 (UTC) Received: from phl-compute-03.internal (phl-compute-03.internal [10.202.2.43]) by mailfhigh.phl.internal (Postfix) with ESMTP id 6E3E5140003D; Tue, 4 Aug 2026 12:49:50 -0400 (EDT) Received: from phl-frontend-03 ([10.202.2.162]) by phl-compute-03.internal (MEProxy); Tue, 04 Aug 2026 12:49:50 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:message-id:mime-version:reply-to :subject:subject:to:to; s=fm2; t=1785862190; x=1785948590; bh=66 UmhgWFMwTTye6zAxB0LnceRbilFURjnH8a0mLuxNQ=; b=FzDCL/ssFxIiIHHGMB iBUGAzybAwLOH+1qgF22pRVnac0hdolTng6a61LEfJnvmV9BN+zp3JH45VLWPsgC E+zlmyqGyn8l3N0nD7C/TWaA5s5M1y1oQBCz6HzsyaMUHrm9tkqreGsyh3CdtgWH yv9A0W8MIY7EeV0R7QI3/R/SjCV7DrgzV8ZHe320WSkc4MI0ed349W6/8TlQx13b Cul74wejETUbNLPDMBezCh/5MWaUNQCRXoxwBDQx142ikvVjwQaq6YEYDCTXQMVl JkxSnXVhXGJf0XIagvmVfMQZKnx5J6t37lc1L4UjinPEHJqn3XFX2RaGVgBRHAYN dI7Q== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:message-id:mime-version:reply-to:subject :subject:to:to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; t=1785862190; x=1785948590; bh=66UmhgWFMwTTye6zAxB0LnceRbil FURjnH8a0mLuxNQ=; b=SjB9NHbiLgKJ3v+z+LoHRob4/Pl/4CzbaYwsGz8arsJz nSEL8i2EEGZ10DVjJliivUhKpW/e4BtiPR8aPHOeJ7aHJiIwrnJqd5XYixAtGGB3 58078DOIhe0h4QxRuGZ7CcOZ39ODBVDDPxvmCiSRECnaPDo0KNt8QFd3s88MAehT /HwO52hTqIZ1RTgoMIiYz/JxlsS107jrBJSvNl+LvtJU5H6IdTdRWzxgDPK2uFmw xa4NBAjFSYoxPR6xBaf+LE1H0zn86wSJ3lsnLqaw48YRBC8aHGgnlmHot5oVTGVO 0X/2lEyM/G8YqLd+sS4zOWdFzHhbSJAzm6yyalniKA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTEpnk88HlkDL2vuK7+YhN9VKTUpq52Vcgzk8Ot3FutCKOaQqnSN0dUJxuRyZoThkg IXhLpG1ohCkAnSXIEsMGq1PFzWBq6AMafyNnG8OgSa6wuOYuuzaWGfQ6IjiUAHtbqZuzvW 4KLQ7fpMpEDgTLQDz7RrFJrwzY/2bbUhaWa8Ar2cSAXwIMvTQg8MHxWRfdgfEjueutzyhT ox7gi8Hk8VK0oY7djCsodsu778n/9xnZwcP4tJy3WLGif0b99GvRIKAyugMDv5km1wSaRS PIdQMe2pzRfJ8t5+HPUCpj/nNg9y2dQMdkBNT9OXjdsipsM6xgeEU1OPxNunB0cMGToMME SDXYl6+pGTfcioZbNtjmUXA+0OdnL3Axj2azsXs2RRLS+DVS3gpM24uFIG3QXXVsiQxE08 7vnVFQRL387mPQMA2l8pT29Bj9XUkwv5TPXBLUbOZtOP0r/zSUl74d6zdIfgu+/HH+SZOg e4n13kqBFwcVM+gVAK+Tao3FgPnVU5PMXK3HYWAtEu0DmEiYJm6d0/e7WZNeoS+mfzfvsE eBBrTyoTp1oE3GrZyrD9P9LdWI1JKC1j+sADl5qjvyQgPHU/3p9euk+MVsyBTJfYf2KxYa lNlwvL+Cgs8wPFXxFBr/vWii2dy8fvHzNpL19eF1zydUoYva/oMZWDiR9ZnQ X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 4 Aug 2026 12:49:49 -0400 (EDT) Received: by fw12.qyliss.net (Postfix, from userid 1000) id 0B6F7C77C9AB; Tue, 04 Aug 2026 18:49:48 +0200 (CEST) From: Alyssa Ross To: devel@spectrum-os.org Subject: [PATCH] Documentation: document expectations around AI use Date: Tue, 4 Aug 2026 18:41:10 +0200 Message-ID: <20260804164109.175987-2-hi@alyssa.is> X-Mailer: git-send-email 2.55.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Message-ID-Hash: DKFKMKMFCBMQS5D6GZVXP5RUQKBXRTPB X-Message-ID-Hash: DKFKMKMFCBMQS5D6GZVXP5RUQKBXRTPB X-MailFrom: hi@alyssa.is X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; header-match-devel.spectrum-os.org-3; header-match-devel.spectrum-os.org-4; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Valentin Gagarin , Demi Marie Obenour , =?UTF-8?q?Vaida=20Plankyt=C4=97?= , Yureka , colbyt X-Mailman-Version: 3.3.10 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: It's been suggested to me a couple of times recently that having some statement about AI use in contributions would be helpful, for a couple of different reasons: • It resolves uncertainty contributors may feel about whether their AI-assisted contributions will be welcome, since there is a wide range of acceptance among open source software projects currently. • It teaches people submitting assisted contributions to avoid pitfalls that might reduce the success of their contributions without otherwise having been obvious to them. • It protects against precious reviewer time being spent trying to sift through verbose and confusing LLM-generated descriptions, which tends to be much less efficient for the reviewer. I've tried to keep it as simple and minimally invasive as possible, focusing on remedying specific problems that are likely to come up. Each expectation has a brief explanation, because I expect people will be happier following the guidance if they understand the reason for it, but I've avoided going into too much detail to keep it easy to read, understand and remember the whole thing. There's some slight deliberate ambiguity, because the important thing here is that people follow the spirit of the expectations. They don't need to get in the way in situations where it would obviously make sense to do something different; for example I can imagine certain situations where it would be useful to share some LLM-generated prose. Signed-off-by: Alyssa Ross --- We had a conversation about this on Matrix a little while ago, and I hope this captures the consensus we had at the time. I'm CCing everybody who's posted to the list recently (I think — sorry if I missed someone), because it's of course important to make sure there's broad awareness of and agreement on the expectations. I expect to apply this on top of my nav_order renumbering patch from earlier, so this would show up in the documentation index after "Communication channels" and before "Sending Your Patch", since it's important context for people to have before sending their first patch. Documentation/doc/contributing/ai.adoc | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 Documentation/doc/contributing/ai.adoc diff --git a/Documentation/doc/contributing/ai.adoc b/Documentation/doc/contributing/ai.adoc new file mode 100644 index 00000000..7535578e --- /dev/null +++ b/Documentation/doc/contributing/ai.adoc @@ -0,0 +1,23 @@ += Use of AI in Spectrum contributions +:page-nav_order: 150 + +// SPDX-FileCopyrightText: 2026 Alyssa Ross +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0 + +Non-trivial Large Language Model (LLM) output in Spectrum contributions should +be clearly marked as such. +This is important context for reviewers, because humans and LLMs are prone to +different kinds of mistakes. + +LLM-generated prose is discouraged. +It tends to be overly verbose, and can be confusing because misunderstandings or +false assumptions tend to be more difficult to spot in prose from LLMs than from +humans. + +Contributors should ensure they understand and are able to answer questions about +contributions they submit, in their own words. +It's generally unhelpful to send LLM output in response to questions, because it +can be expected that reviewers can ask LLMs questions themselves if LLM-generated +answers would be useful to them. +If a reviewer asks a contributor a question, it's because they want that +contributor's answer, not an LLM's. base-commit: 9dc81e02d6382ef7fc89b9bb246a71ff0fcc68ff -- 2.55.0