From 010c8b28dd7b587c6ca2efaf584e012e33c10ef0 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Sun, 18 Oct 2026 13:10:26 +1100 Subject: [PATCH] docs(ui): no captions that describe the view --- ui/AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/ui/AGENTS.md b/ui/AGENTS.md index 9fd6a7291..8adea5d94 100644 --- a/ui/AGENTS.md +++ b/ui/AGENTS.md @@ -36,6 +36,9 @@ state; the UI presents them and submits operator choices. - Keep controls compact and contextual. Use on-demand panels and inline hover/focus icon actions rather than permanent chrome. Do not repeat labels in explanatory text or add controls without working behavior. +- Text states a problem or an action, never what the view already shows. No + captions like "Compared with the current definition" or "Refreshed every 5 + seconds"; delete them on sight. - Preserve keyboard operation, visible focus, accessible names, dialog titles and table semantics. A hover action must also be reachable by keyboard. - Keep filtering and pagination consistent with the server. State limitations