docs: explain View Quick Access focus behavior

README.md

@@ -79,3 +79,9 @@ assignments but above user/default selection. The View must already be
 available to the account, so Workflow cannot bypass assignment policy.
 Persisting a workflow instance's pinned View revision remains owned by the
 Workflow module.
+
+A View may also recommend or focus Quick Access tools. Focus narrows only the
+already effective, authorized catalogue. The rail identifies the active View,
+explains a focus whose tools are no longer available, and exposes **All
+available tools** as a temporary permission-derived escape; that action neither
+changes the View nor stores an override.

src/govoplan_views/backend/manifest.py

@@ -309,7 +309,9 @@ manifest = ModuleManifest(
                 "permission checks. A revision may recommend Quick Access tools or "
                 "focus the rail to a task-specific subset. These fields affect presentation "
                 "only: unavailable, context-incompatible, or unauthorized tools stay absent, "
-                "and an unusable focus falls back to the normal effective rail. Workflow uses "
+                "and an unusable focus falls back to the normal effective rail with an explanation. "
+                "While a focus is active, All available tools temporarily restores that same permission-derived "
+                "rail without changing the View or saving an override. Workflow uses "
                 "the same behavior by resolving the exact immutable View revision."
             ),
             layer="available",
@@ -325,7 +327,8 @@ manifest = ModuleManifest(
                         "den Plattformvertrag. Eine Revision darf Schnellzugriffswerkzeuge empfehlen oder die Leiste auf eine "
                         "aufgabenbezogene Teilmenge fokussieren. Das aendert nur die Darstellung: nicht verfuegbare, unpassende "
                         "oder unberechtigte Werkzeuge bleiben verborgen; ein nicht nutzbarer Fokus faellt auf die normale wirksame "
-                        "Leiste zurueck. Workflow erhaelt dasselbe Verhalten durch die genaue unveraenderliche Ansichtsversion. "
+                        "Leiste mit einer Erklaerung zurueck. Alle verfuegbaren Werkzeuge stellt voruebergehend dieselbe "
+                        "berechtigungsabgeleitete Leiste wieder her, ohne die Ansicht zu aendern. Workflow erhaelt dasselbe Verhalten durch die genaue unveraenderliche Ansichtsversion. "
                         "Ausgeblendete Funktionen bleiben durch ihre normalen Berechtigungspruefungen geschuetzt."
                     ),
                 }
@@ -377,7 +380,9 @@ manifest = ModuleManifest(
                 " Product-area grouping, ordering, and labels are presentation metadata in the same revision; "
                 "they cannot expose a hidden surface or grant authority. Grouped navigation is the sensible default, "
                 "while flat navigation preserves the complete authorized tool rail. Quick Access recommendation and "
-                "focus ids are likewise revisioned presentation metadata and never authorize a contribution."
+                "focus ids are likewise revisioned presentation metadata and never authorize a contribution. The runtime's "
+                "All available tools escape can only reveal contributions that already survived entitlement, policy, preference, "
+                "surface, context, and permission checks."
             ),
             documentation_types=("admin",),
             audience=("administrator", "power_user", "workflow_designer"),