Screens that are easy to misread — lead distribution, analytics, the send-estimate modal, an opportunity card — carry a hint icon in the header. Clicking it starts the tutorial for that exact surface. The hint renders nothing at all if its tutorial has not been written yet, if the user hid the Academy, or if the tutorial is gated away from their role.
Also called: contextual help · help icon · learn this screen · inline tutorial link
- 1A component is dropped in a screen header with a tutorial id
- 2It subscribes to the tutorial registry so it appears the moment its lesson is registered
- 3It hides itself when the tutorial is unregistered, the Academy is switched off, or the user's role is excluded
Help filed away in its own section is help nobody opens at the moment they are stuck; they guess instead, or they ring the office. So the screens with the most moving parts carry a small cap icon in the header that starts that screen's own lesson right there. The icon appears only where a lesson actually exists, so it is never a button that does nothing — which is the usual way in-context help loses people's trust.
- Users hit confusion on a screen and have to go hunting in a help section
- Contextual help links rot into dead buttons
See it on your own jobs
Twenty minutes, your numbers, no slide deck. We’ll build one of your real buildings in front of you and send you the estimate link at the end — yours to keep either way.
or keep browsing features →