docs: archive 9 legacy/obsolete docs to legacy-obsolete-2026-07-25/ with SUPERSEDED log

2026-07-26 16:00:56 +09:00
parent 4f31d4f66a
commit 589a1044e6
10 changed files with 59 additions and 0 deletions
@@ -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/<file>.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