docs: clarify Xorg-first platform stance

2026-04-11 21:13:52 -04:00
parent 23abeca651
commit 60d3fc613b
1 changed files with 7 additions and 0 deletions
@@ -24,6 +24,13 @@ This repository is a screen reader. Prioritize accessibility, correctness, and s
 - If repo and installed behavior differ, prefer rebuilding with `./build-local.sh` over patching the installed package directly.
 - Treat direct edits under `~/.local/.../cthulhu/` as an exception path that requires explicit user approval.

+## Platform support stance
+- **critical** Robust Xorg support is required and is a merge gate for Cthulhu.
+- Wayland support is desirable, but it is secondary to keeping Xorg stable and usable.
+- If a change that improves Wayland would break, weaken, or regress Xorg support, the answer is a hard no by default.
+- If the user explicitly insists on such a change anyway, warn them plainly that the change is expected to be rejected without further consideration as long as Xorg is adversely affected.
+- Prefer desktop-agnostic fixes first. If a tradeoff is unavoidable, choose the path that preserves Xorg correctness and defer the Wayland-specific improvement.
+
 ## Coding guidelines
 - **When modifying existing code:** follow the surrounding code’s conventions.
 - **When writing new code from scratch:** prefer