Help entries belong next to where problems occur
Aliases: contextual help entry · safe context handoff · in-place help
What it is
A privacy-safe contextual help handoff places help near hesitation, error, or a complex task and carries the minimum task and state context needed for resolution, such as page concept, public error class, and current step. It preserves work and lands on the relevant answer instead of making users reconstruct the situation. It does not replace clear labels, pre-guidance, valid error recovery, or an interface that should be directly usable.
Why it happens
Help-seeking motivation and problem context co-occur. After leaving the page, users must remember object, state, and attempted action. Safe context can select the relevant content or prefill non-sensitive diagnostics. Passing a whole form, query, account, resource name, or token turns convenience into disclosure; landing at a generic homepage discards the contextual value. Stable task IDs, public state classes, and versions connect the two sides without raw sensitive data.
Studying it
Sample verified confusion points and failure paths. Compare contextual entry, global entry, and direct UI correction on answer arrival, task recovery, state preservation, return, and human escalation. Cover deep links, account switching, changed permission, offline use, stale articles, keyboard, and screen-reader focus. Security review inspects URLs, telemetry, third-party analytics, screenshots, and support-prefill fields for leakage through history or shared devices.
Where it stops holding
Not every control needs help. Repeated confusion may require a better label, constraint, default, or flow first. State frequent, short, actionable guidance directly in the interface rather than hiding critical answers in documentation. Complex explanations, uncommon failures, and cross-step concepts suit contextual help; global help remains a backstop for cross-page questions. User-generated content and sensitive values do not travel with the entry by default.
Applying it
- Register task or concept ID, public state or error class, product version, destination article and anchor, allowed parameters, owner, and invalidation rule. Use an allowlist and send no raw content.
- Make anchor text promise a specific answer. Preserve return path, form or query state, and focus. After a sign-in boundary, recheck identity and authorization before personalized content appears.
- Route directly fixable UI problems into the product backlog, treating help as support rather than a permanent patch. If content is retired, renamed, or version-incompatible, fall back safely to the nearest valid task page.
- Measure entry → answer → recovery end to end rather than clicks alone. Audit dead links, sensitive query parameters, cross-account state, and assistive-technology reachability.
Related
- Same group: T3.02.1 Organize help by user task, not by feature module · T3.02.3 Search must tolerate user vocabulary and synonyms
- Adjacent: T2.10.1 Microcopy lives where decisions and hesitation happen · T2.04.1 Say what happened, why, and what to do
- Search terms:
contextual help·safe context handoff·in-place assistance