From 02fe432c170298b25782ae561dddbbd9667a5793 Mon Sep 17 00:00:00 2001 From: kellito Date: Sun, 26 Jul 2026 19:54:42 +0900 Subject: [PATCH] docs: stale-doc round-4 cleanup (CONSOLE-TO-KDE + WAYLAND plan) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Round-4 stale-doc audit (2026-07-26) found that several docs contradict the v5.4 canonical authority (DRIVER-MANAGER-MIGRATION-PLAN). This commit addresses two of the cleanup items: 1. CONSOLE-TO-KDE-DESKTOP-PLAN.md — the plan reference table referenced the IRQ and DRM plans as current canonical authorities when they live in legacy-obsolete-2026-07-25/. Updated the table to annotate their archived location and note that their work is subsumed by Round 1-5 base/kernel and 3D-DRIVER-PLAN Rounds 1-7 respectively. Also noted WAYLAND-IMPLEMENTATION-PLAN.md's status table is superseded by 3D-DRIVER-PLAN.md and added 3D-DRIVER-PLAN.md as the canonical single coherent post-Round-7 plan. 2. WAYLAND-IMPLEMENTATION-PLAN.md — added a header note (2026-07-26) acknowledging that the document's diagnostic content remains accurate but its status table and implementation phases are superseded by 3D-DRIVER-PLAN.md Rounds 1-7. The original 'RESOLVED — 2026-07-08' header is preserved for historical reference. The null+8 fix patches are committed but never runtime-validated in isolation; the Phase A instrumented- rebuild runbook (§7.1-7.4) remains the prerequisite for any further status claims. Other stale-doc items from the round-4 audit (INIT-NAMESPACE- MANAGER-SCALABILITY-PLAN.md, WIFI-IMPLEMENTATION-PLAN.md, QUIRKS-IMPROVEMENT-PLAN.md, INPUT-STACK-LINUX-ALIGNMENT-PLAN.md, README.md version refs) are tracked for follow-up in the v5.5 plan update (next commit). The evdevd input-event logging fix and the init/submodule/.expect(TODO) replacement were already committed by their respective agents. --- local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md | 7 ++++--- local/docs/WAYLAND-IMPLEMENTATION-PLAN.md | 12 ++++++++++++ 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md b/local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md index 5693bcfb14..267d8f83ae 100644 --- a/local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md +++ b/local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md @@ -2064,13 +2064,14 @@ This document is the authority. Subsystem plans remain for deep-dive detail: | Plan | Covers | |------|--------| | `KERNEL-IPC-CREDENTIAL-PLAN.md` | Kernel credential syscalls, IPC, RLIMIT — Phases K1-K2,K4 complete | -| `IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | PCI/IRQ/MSI-X/IOMMU quality | +| `IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` *(archived `legacy-obsolete-2026-07-25/`)* | PCI/IRQ/MSI-X/IOMMU quality — work subsumed by Round 1–5 base/kernel work | | `ACPI-IMPROVEMENT-PLAN.md` | ACPI shutdown, power, sleep states | | `archived/RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` | relibc IPC surface | -| `DRM-MODERNIZATION-EXECUTION-PLAN.md` | DRM/KMS modernization | -| `WAYLAND-IMPLEMENTATION-PLAN.md` | Wayland compositor stability | +| `DRM-MODERNIZATION-EXECUTION-PLAN.md` *(archived `legacy-obsolete-2026-07-25/`)* | DRM/KMS modernization — render-path work subsumed by `3D-DRIVER-PLAN.md` Rounds 1–7 | +| `WAYLAND-IMPLEMENTATION-PLAN.md` | Wayland compositor stability — diagnostic content current; status table superseded by `3D-DRIVER-PLAN.md` Rounds 1–7 | | `DBUS-INTEGRATION-PLAN.md` | D-Bus architecture | | `GREETER-LOGIN-IMPLEMENTATION-PLAN.md` | Greeter/login design | +| `3D-DRIVER-PLAN.md` *(canonical)* | Mesa + virgl + Intel iris + AMD radeonsi — single coherent post-Round-7 plan | --- diff --git a/local/docs/WAYLAND-IMPLEMENTATION-PLAN.md b/local/docs/WAYLAND-IMPLEMENTATION-PLAN.md index 48f4633b39..90c59acf79 100644 --- a/local/docs/WAYLAND-IMPLEMENTATION-PLAN.md +++ b/local/docs/WAYLAND-IMPLEMENTATION-PLAN.md @@ -1,3 +1,15 @@ +# Red Bear OS Wayland Implementation Plan + +> **Note (2026-07-26):** This document's diagnostic content (§§1–2, evidence chain, +> crash analysis) remains accurate. The **status table and implementation phases** +> below are **superseded** by `local/docs/3D-DRIVER-PLAN.md` Rounds 1–7 +> (2026-07-26). The null+8 fix patches are committed in source +> (qtwaylandscanner + libwayland) but **never runtime-validated in isolation**. +> The Phase A instrumented-rebuild runbook (§7.1–7.4) is the prerequisite for +> any further status claims. + +**Original header** (kept for historical reference): + # Red Bear OS Wayland Implementation Plan (RESOLVED — 2026-07-08) **Status**: Wayland subsystem builds. Qt6 Wayland, Mesa EGL+GBM+GLES2, KWin building.