From a1dc662c39b23b96812dc23b1c4f7c27af06a586 Mon Sep 17 00:00:00 2001
From: Markus Fritsche <mfritsche@reauktion.de>
Date: Tue, 28 Apr 2026 19:54:06 +0000
Subject: [PATCH] upstream-submissions: top-level README

Index README for upstream-submissions/. Captures:
- Directory layout (3 subdirs, one per series).
- Where the actual patch files live.
- Submission status table (none filed yet).
- Validation gates common to all three series.
- Recommended submission order: vb2-dma-resv first (the
  architectural correction the kwin patch's premise depends on),
  qt6-base-fourier independently anytime, kwin-fourier last
  with reference to the merged/in-flight kernel patch.
- Cadence after submitting: review feedback loop, LTS backport
  requests, eventual retirement of the local -fourier packages
  once the upstream changes ship.
---
 upstream-submissions/README.md | 77 ++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 upstream-submissions/README.md

diff --git a/upstream-submissions/README.md b/upstream-submissions/README.md
new file mode 100644
index 000000000..257891b04
--- /dev/null
+++ b/upstream-submissions/README.md
@@ -0,0 +1,77 @@
+# upstream-submissions/
+
+Drafts of the upstream submission texts for the patch series in
+`arch/` and `kernel/`. Each subdirectory pairs a patch series with
+the issue / merge-request / mailing-list body that should accompany
+it when going upstream.
+
+## Layout
+
+```
+upstream-submissions/
+├── qt6-base-fourier/       # bugreports.qt.io issue + Gerrit notes
+│   └── qt-bug-report.md
+├── kwin-fourier/           # invent.kde.org MR body + KDE flow notes
+│   └── kde-mr-body.md
+└── vb2-dma-resv/           # linux-media cover letter + send-email recipe
+    └── lkml-submission-notes.md
+```
+
+The patches themselves live in:
+
+- `arch/qt6-base-fourier/0001..0003-*.patch` (Qt 6 patches)
+- `arch/kwin-fourier/0002-*.patch` (KWin upstream-shape patch;
+  `0001-*-bypass-*.patch` is the local diagnostic, not for
+  upstream)
+- `kernel/vb2-dma-resv-rfc/0001..0003-*.patch` plus
+  `0000-cover-letter.patch` (kernel patches)
+
+## Submission status
+
+| Series | Bug filed | Patches submitted | Landed |
+|---|---|---|---|
+| qt6-base-fourier | not yet | not yet | not yet |
+| kwin-fourier (0002) | n/a — KDE goes straight to MR | not yet | not yet |
+| vb2-dma-resv | n/a — kernel goes straight to mailing list | not yet | not yet |
+
+## Validation gates before submitting
+
+Each subdirectory's notes file lists the validation gates specific
+to that series. Common to all three:
+
+- Patches must apply cleanly to the latest upstream branch (rebase
+  before sending).
+- Build must complete (compile-test for kernel; the others are
+  already validated as building cleanly).
+- End-to-end runtime test on ohm should still pass with the patch
+  applied (preferably with the *other* layers of the campaign also
+  applied, so the patch doesn't get blamed for behavior in another
+  layer).
+
+## Submission order
+
+Recommended:
+
+1. **vb2-dma-resv** to linux-media first. The kernel-side fix is
+   the architectural correction that makes the kwin patch's
+   premise (the wait will signal correctly) actually true. If the
+   kernel patch isn't merged or accepted, the kwin patch
+   submission can still proceed but on weaker rationale.
+
+2. **qt6-base-fourier** to bugreports.qt.io + Gerrit second.
+   Independent of the others; pure spec-correctness improvement
+   for OpenGL ES 3.x, can land at any time.
+
+3. **kwin-fourier (0002)** to invent.kde.org last, ideally
+   referencing the merged or in-flight kernel patch as the
+   underlying correctness fix.
+
+## Cadence after submitting
+
+- Watch each upstream for review feedback; revise and resubmit.
+- After landing, request backports to LTS branches where
+  applicable (Qt 6.5 LTS, Plasma 6.x, kernel stable).
+- Once landed in a release shipping to Arch / Debian / etc., the
+  corresponding `arch/*-fourier/` package becomes redundant and
+  can be retired (drop the `epoch=1` override, archive the
+  PKGBUILD as historical reference).