Apply guided scheduling interface patterns

This commit is contained in:
2026-08-03 08:29:29 +02:00
parent 3e9a14a970
commit 3d8272b28e
7 changed files with 225 additions and 4 deletions
@@ -111,6 +111,36 @@ DOCUMENTATION = (
related_modules=("poll", "calendar", "notifications", "mail"),
metadata={"kind": "reference"},
),
DocumentationTopic(
id="scheduling.calendar-coordination",
title="Configure scheduling calendar coordination",
summary="Understand the Calendar capability and permissions required for conflict checks, tentative holds, and final event handoff.",
body=(
"Calendar coordination remains optional. It is available only when Calendar contributes its picker capability and the actor can read calendars and availability and write events. "
"A disabled Calendar control therefore names the missing integration or authority instead of silently accepting a configuration that cannot run. "
"Administrators should enable the Calendar module and grant the bounded calendar, availability, and event permissions needed by the organizer; Scheduling never imports Calendar internals."
),
layer="configured",
documentation_types=("admin", "user"),
audience=("organizer", "module_admin", "tenant_admin"),
related_modules=("calendar", "access", "policy"),
metadata={"kind": "reference", "context_ids": ["scheduling.calendar-integration"]},
),
DocumentationTopic(
id="scheduling.participation-governance",
title="Govern public scheduling participation",
summary="Resolve disabled guest invitations without weakening signed-link privacy or participation policy.",
body=(
"Public invitation links are issued only when the configured response, privacy, password, email, and update controls can be enforced by the public participation gateway. "
"When enforcement is unavailable, signed-in participants may continue to respond through their assigned request, but the system does not issue a weaker guest link. "
"A system or tenant administrator must restore the governed Poll/public-participation capability or keep the request limited to signed-in participation."
),
layer="configured",
documentation_types=("admin",),
audience=("operator", "module_admin", "tenant_admin"),
related_modules=("poll", "policy", "access"),
metadata={"kind": "pattern", "context_ids": ["scheduling.public-participation-blocker"]},
),
)