From e87076f86b622f9fb4c9d7cae9a565ceacbe286b Mon Sep 17 00:00:00 2001 From: Albrecht Degering Date: Wed, 19 Aug 2026 20:14:02 +0200 Subject: [PATCH] docs: explain View Quick Access focus behavior --- README.md | 6 ++++++ src/govoplan_views/backend/manifest.py | 11 ++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 1333c0f..945367a 100644 --- a/README.md +++ b/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. diff --git a/src/govoplan_views/backend/manifest.py b/src/govoplan_views/backend/manifest.py index f520b3c..41c3d82 100644 --- a/src/govoplan_views/backend/manifest.py +++ b/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"),