From 589a1044e67d4a705cf7cb6c4c3f59ff4e309f6c Mon Sep 17 00:00:00 2001 From: vasilito Date: Sun, 26 Jul 2026 16:00:56 +0900 Subject: [PATCH] docs: archive 9 legacy/obsolete docs to legacy-obsolete-2026-07-25/ with SUPERSEDED log --- .../BUILD-SYSTEM-ASSESSMENT-2026-07-18.md | 0 .../BUILD-SYSTEM-HARDENING-PLAN.md | 0 .../DRM-MODERNIZATION-EXECUTION-PLAN.md | 0 .../{ => legacy-obsolete-2026-07-25}/HOOKS.md | 0 .../INITNSMGR-CONCURRENCY-DESIGN.md | 0 ...D-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md | 0 .../PATCH-PRESERVATION-AUDIT-2026-07-12.md | 0 .../legacy-obsolete-2026-07-25/SUPERSEDED.md | 59 +++++++++++++++++++ .../UPSTREAM-SYNC-PROCEDURE.md | 0 .../redbear-power-improvement-plan.md | 0 10 files changed, 59 insertions(+) rename local/docs/{ => legacy-obsolete-2026-07-25}/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/BUILD-SYSTEM-HARDENING-PLAN.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/DRM-MODERNIZATION-EXECUTION-PLAN.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/HOOKS.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/INITNSMGR-CONCURRENCY-DESIGN.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/PATCH-PRESERVATION-AUDIT-2026-07-12.md (100%) create mode 100644 local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md rename local/docs/{ => legacy-obsolete-2026-07-25}/UPSTREAM-SYNC-PROCEDURE.md (100%) rename local/docs/{ => legacy-obsolete-2026-07-25}/redbear-power-improvement-plan.md (100%) diff --git a/local/docs/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md b/local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md similarity index 100% rename from local/docs/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md rename to local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md diff --git a/local/docs/BUILD-SYSTEM-HARDENING-PLAN.md b/local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md similarity index 100% rename from local/docs/BUILD-SYSTEM-HARDENING-PLAN.md rename to local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md diff --git a/local/docs/DRM-MODERNIZATION-EXECUTION-PLAN.md b/local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md similarity index 100% rename from local/docs/DRM-MODERNIZATION-EXECUTION-PLAN.md rename to local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md diff --git a/local/docs/HOOKS.md b/local/docs/legacy-obsolete-2026-07-25/HOOKS.md similarity index 100% rename from local/docs/HOOKS.md rename to local/docs/legacy-obsolete-2026-07-25/HOOKS.md diff --git a/local/docs/INITNSMGR-CONCURRENCY-DESIGN.md b/local/docs/legacy-obsolete-2026-07-25/INITNSMGR-CONCURRENCY-DESIGN.md similarity index 100% rename from local/docs/INITNSMGR-CONCURRENCY-DESIGN.md rename to local/docs/legacy-obsolete-2026-07-25/INITNSMGR-CONCURRENCY-DESIGN.md diff --git a/local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md b/local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md similarity index 100% rename from local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md rename to local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md diff --git a/local/docs/PATCH-PRESERVATION-AUDIT-2026-07-12.md b/local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md similarity index 100% rename from local/docs/PATCH-PRESERVATION-AUDIT-2026-07-12.md rename to local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md diff --git a/local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md b/local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md new file mode 100644 index 0000000000..ad76c65bd7 --- /dev/null +++ b/local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md @@ -0,0 +1,59 @@ +# Legacy Obsolete Documents Archive (2026-07-25 Round 5 audit) + +This folder contains documents that have been superseded by more +recent or canonical versions. They are retained here for historical +reference and to preserve the audit trail, but they should NOT be +treated as current status. + +## What was moved here and why + +| File | Superseded by | +|---|---| +| `DRM-MODERNIZATION-EXECUTION-PLAN.md` | `local/docs/3D-DRIVER-PLAN.md` (Rounds 1-5) | +| `BUILD-SYSTEM-HARDENING-PLAN.md` | `local/recipes/AGENTS.md` + `local/docs/3D-DRIVER-PLAN.md` | +| `IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | Subsumed by Round 1-5 kernel work | +| `INITNSMGR-CONCURRENCY-DESIGN.md` | Subsumed by Round 1-3 base work | +| `BUILD-SYSTEM-ASSESSMENT-2026-07-18.md` | Subsumed by Round 1-5 build system work | +| `PATCH-PRESERVATION-AUDIT-2026-07-12.md` | Round 7 audit; Round 5 refreshed it | +| `HOOKS.md` | Subsumed by per-crate inline doc comments | +| `redbear-power-improvement-plan.md` | v1.0-1.6 features completed; TUI evolved | +| `UPSTREAM-SYNC-PROCEDURE.md` | `local/scripts/sync-versions.sh` + `bump-release.sh` | + +## Why archive rather than delete + +The Round 1-5 work on the 3D/graphics stack subsumed the +DRM-MODERNIZATION-EXECUTION-PLAN's render-path work. The +build system hardening work is captured in the per-component +`AGENTS.md` files in `local/`, `recipes/`, and `recipes/wip/`. The +hook documentation is captured inline in each crate's `AGENTS.md` +rather than in a single global file. + +These files are preserved here because: +1. The audit trail matters: future maintainers need to know what was + tried, what was rejected, and what was superseded. +2. Some content (build system hardening, IRQ enhancement) may be + revisited as separate work items. +3. The Round 5+ rounds 1-5 each have their own SUPERSEDED log + (legacy-superseded-2026-07-12, legacy-absorbed-2026-07-12, + legacy-recipe-patches/) — this folder is the Round 5 + equivalent. + +## Restoration + +If a future maintainer needs to re-evaluate a moved document: + +```bash +git mv local/docs/legacy-obsolete-2026-07-25/.md local/docs/ +``` + +## See also + +- `local/docs/3D-DRIVER-PLAN.md` — current canonical graphics plan (Rounds 1-5) +- `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` — current canonical desktop plan +- `local/docs/REDBEAR-FULL-SDDM-BRINGUP.md` — current SDDM bring-up status +- `local/docs/QT6-WAYLAND-NULL8-DIAGNOSIS.md` — Qt6 null+8 root-cause work +- `local/docs/BUILD-CACHE-PLAN.md` — current build cache system +- `local/docs/PACKAGE-BUILD-QUIRKS.md` — current build quirks +- `local/docs/LOCAL-FORK-SUPREMACY-POLICY.md` — current fork model +- `local/docs/QUIRKS-AUDIT.md` — current quirks system +- `local/docs/HOOKS.md` (archived) — global hook doc superseded by per-crate docs diff --git a/local/docs/UPSTREAM-SYNC-PROCEDURE.md b/local/docs/legacy-obsolete-2026-07-25/UPSTREAM-SYNC-PROCEDURE.md similarity index 100% rename from local/docs/UPSTREAM-SYNC-PROCEDURE.md rename to local/docs/legacy-obsolete-2026-07-25/UPSTREAM-SYNC-PROCEDURE.md diff --git a/local/docs/redbear-power-improvement-plan.md b/local/docs/legacy-obsolete-2026-07-25/redbear-power-improvement-plan.md similarity index 100% rename from local/docs/redbear-power-improvement-plan.md rename to local/docs/legacy-obsolete-2026-07-25/redbear-power-improvement-plan.md