Navigating the App¶
This page describes the layout of the Mention interface and how to find your way around.
Sidebar¶
The sidebar on the left of the screen includes:
- Mention logo — top left; click to return to the audience list
- Audiences — every Audience you belong to, each with a chip showing your role (OWNER or LEARNER). Click one to open it.
- Organization switcher — in the footer. If you belong to more than one organization, switch between them here.
- Account menu — your name and avatar in the footer. Opens account settings, the light/dark/system theme options, and sign out.
- Notification bell — in the footer, next to your name. Shows your notifications with an unread badge.
On a narrow window (below tablet width) the sidebar gives way to a bottom tab bar with the same destinations — the app is the same either way.
Learner home: Ask and Hub¶
Opening an Audience as a learner gives you two tabs. Which one you land on depends on whether you are current (every lesson finished, nothing overdue for review):
- Not current — you land on Hub, because you have something to do. A badge on the Audience name and on the Hub tab shows how much is left.
- Current — you land on Ask, a multi-turn conversation grounded in your organization's sources. Hub stays one click away.
Hub¶
The page header carries a Lessons strip — how many you have finished, out of the lessons that have been composed so far. Right below the header sits Ask, so a question is never more than a keystroke away — type it here and you drop straight into a grounded thread with the answer already coming back, with a few starter prompts to get going. Below it is your next action as a large card — start review if something is due, or continue the next lesson.
Below that is the Audience's contents shelf, grouped by what each article is for: Learn by doing, Get something done, Look something up, and Understand why. A group with nothing in it is not shown, and anything still being written sits under Being written until it is.
Each row shows the entry's name and where you stand on it — how much of its material you have mastered, a Complete badge once you have passed all of it, or the lesson's status if it hasn't been composed yet.
Clicking a row gives you whichever half you have earned. An entry whose lesson you haven't finished opens the lesson, because that is what the entry is asking of you. Once you have passed it, the row opens the article instead. Looking something up mid-lesson is handled inside the exercise itself, which offers you the passage it was written from — see below.
Ask¶
Ask is the place for grounded questions in your own words, including follow-ups in the same thread. See Asking Questions.
The lesson player¶
Opening a lesson from your contents gives you it one exercise at a time, each with a setup you respond to and a correction you get back once you commit. Nothing is revealed before you answer.
On an exercise you also get:
- a progress bar and the exercise's position in the lesson;
- Look it up — the passage of the article the exercise was written from. A lesson is an open-book test: opening it costs you nothing and is not recorded, because finding the material and applying it is the thing you are practising. It also links to the full article if you want the rest of it.
Once you have finished every lesson in an audience, its contents screen offers the final exam — a single roleplay conversation drawn across everything the audience taught you, with a visible count of the turns you have left and a control to end it early and have it graded as it stands.
When you answer, your answer stays on screen next to the correction, so you can see what you were marked on. If you get one wrong, the same material comes back worded differently and labelled as a second attempt — the exercise number does not move, because it is still the same exercise.
What you have mastered — every piece of material the lesson covers, how strong you are on each, and when it comes back for review — appears when you finish the lesson, and on the contents list.
The article page¶
Once you've finished an entry's lesson, clicking it opens the article: a single markdown document you read top to bottom.
Also on the article page:
- a Contents button to take you back to the list;
- a position counter — 3 of 12 — showing where this entry sits in the contents;
- a Practice this prompt above the document when its lesson is composed and you haven't finished it — an invitation, not a gate, with the whole article right below it;
- links at the bottom to the previous and next entry, so you can work straight through the contents.
If you own an Audience¶
Owners (and org admins) get a different set of tabs, not extra ones. Curating an Audience is not the same as learning from it, so owners do not get the learner's contents screen and are not tracked as learners.
| Tab | What it shows |
|---|---|
| Questions | Gaps members hit when Ask could not answer, and the conflicts routed to this Audience — the owner's default home. See Answering Unanswered Questions and Reviewing Misunderstandings |
| Curriculum | The table of contents you author: entries and their prompts, grouped by what each article is for. Opening an entry gives you its brief, the article written from it, and the lesson composed from that article. See Curating Contents and Curating Lessons |
| People | The Audience's learners and owners, with each learner's progress and status, plus pending invitations. See Monitoring Progress |
You read the articles you commissioned inside Curriculum, on each entry's page, and you can walk through a lesson there without recording anything. Owners can Ask the Audience too — a single grounded answer that cites your sources, to check what it can already answer. On the Questions home the ask sits on the page, below the questions waiting for you and above shortcuts to Curriculum and, for org admins, Contradictions; on the other tabs it stays a compact field at the bottom while you work.
Terms¶
Your organization's terminology reaches you where you need it, rather than on a page of its own. The first mention of a term is a link — in an article's text, and in the exercises and corrections of a lesson: hover or tap it and the definition opens in place, without moving you off the paragraph you were reading.
Where one definition uses another term, that word is a link too — following it swaps what the panel shows, with a back arrow to return. The panel also lists other terms whose definitions mention this one.
If you want a definition and have no article in front of you, ask for it on Ask.
Switching Audiences¶
If your admin has assigned you to more than one Audience, they all appear in the sidebar — click another Audience to switch. Each Audience is a completely independent experience: a different table of contents, different articles and lessons, and separate tracking.
Switching keeps you on the same tab where that makes sense. You can own one Audience and learn from another, and those have different surfaces, so switching between them lands you on that Audience's starting point instead — Questions if you own it, Hub or Ask (depending on whether you are current) if you learn from it.