diff mbox series

contributor-guide: Note patch complexity requirements for stable branches

Message ID 20260810-stable-patch-complexity-v1-1-f192d51f6311@pbarker.dev
State New
Headers show
Series contributor-guide: Note patch complexity requirements for stable branches | expand

Commit Message

Paul Barker Aug. 10, 2026, 8:38 a.m. UTC
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(+)


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

Best regards,
--  
Paul Barker
diff mbox series

Patch

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).