diff --git a/SCREENSHOT_AUTOMATION.md b/SCREENSHOT_AUTOMATION.md index 1ffdf872..4d4fa1d7 100644 --- a/SCREENSHOT_AUTOMATION.md +++ b/SCREENSHOT_AUTOMATION.md @@ -1,6 +1,14 @@ # Screenshot Automation Plan for Bookhoard Documentation -> **Status**: Ready to implement when frontend is complete +> **Status**: REJECTED / ARCHIVED (2026-11-02) — not implementing. +> **Superseded by**: [docs/developer/writing-ui-docs.md](docs/developer/writing-ui-docs.md) — +> Bookhoard docs are written screenshot-free from now on. Why: screenshots go +> stale silently (no gate can diff pixels against the UI), die on every +> redesign, and are unverifiable; the UI is server-rendered so exact labels are +> greppable and gate-checked instead (`TestUIControlLabels`). The prose +> standard teaches patterns that survive re-layouts. Kept below unmodified for +> history. +> > **Last Updated**: 2026-02-03 This document outlines the complete plan for automatically generating screenshots for Bookhoard documentation using Playwright.