Yocto Project Documentation
 help / color / mirror / Atom feed
From: Paul Barker <paul@pbarker.dev>
To: docs@lists.yoctoproject.org
Cc: Yoann Congal <yoann.congal@smile.fr>, Paul Barker <paul@pbarker.dev>
Subject: [PATCH] contributor-guide: Note patch complexity requirements for stable branches
Date: Mon, 10 Aug 2026 09:38:15 +0100	[thread overview]
Message-ID: <20260810-stable-patch-complexity-v1-1-f192d51f6311@pbarker.dev> (raw)

Expand the existing note section under "Submitting Changes to Stable
Release Branches" to provide guidance on (not) submitting large or
complex changes.

Concerns around the increased size and complexity of patches being
submitted for the stable branches (mostly driven by complex
vulnerabilities found and/or fixed via LLM agents) were discussed with
the stable maintainer and the Yocto Project TSC. This patch reflects the
TSC decision that we should push back on these changes to preserve the
maintainability of our stable branches.

Cc: Yoann Congal <yoann.congal@smile.fr>
Signed-off-by: Paul Barker <paul@pbarker.dev>
---
 documentation/contributor-guide/submit-changes.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst
index ae7a097ad53b..9974a6b35987 100644
--- a/documentation/contributor-guide/submit-changes.rst
+++ b/documentation/contributor-guide/submit-changes.rst
@@ -671,6 +671,12 @@ page.
 
 .. note::
 
+   Patches submitted for a stable branch need to be isolated changes that are
+   human readable and understandable. Fixes for CVEs or other issues which have
+   a high complexity, consist of a large number of commits and/or a large
+   numbers of changed lines are unlikely to be accepted due to the difficulty
+   they cause with maintainability and scalability.
+
    Changes will not typically be accepted for branches which are marked as
    End-Of-Life (EOL).
 

---
base-commit: 41dae3c3da3ada1745fc60228ff6269c64ee2361
change-id: 20260810-stable-patch-complexity-1fca314ddf45

Best regards,
--  
Paul Barker



             reply	other threads:[~2026-08-10  8:38 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-10  8:38 Paul Barker [this message]
2026-08-13 12:01 ` [PATCH] contributor-guide: Note patch complexity requirements for stable branches Antonin Godard

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260810-stable-patch-complexity-v1-1-f192d51f6311@pbarker.dev \
    --to=paul@pbarker.dev \
    --cc=docs@lists.yoctoproject.org \
    --cc=yoann.congal@smile.fr \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox