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 has two groups — organization-wide pages on top, then the Audience you are in:
- Organization — the pages that span the whole organization, shown first:
- Conflicts — for org admins, and for owners of the Audience you are in, holding the conflicts routed to it. The contradictions only a person can settle, with a badge counting the pending ones. See Conflicts.
- Sources — org admins only. The connected content Mention reads from. See Sources and Assets.
- Audience switcher — heads the audience group below. It names the Audience you are in; click it to switch to another Audience you belong to, each with a chip showing your role (OWNER or LEARNER). Org admins also get a New audience action here. On an organization page, picking an Audience just repoints the links below it; on an Audience page it takes you there.
- The Audience's own links — Chat and Lessons, whichever role you hold. Lessons is everything written for this Audience, with a badge counting what is outstanding for a learner or how many lessons exist for an owner. Learners additionally get Review (with a badge counting what is due) and, once the final exam is unlocked, under way, or waiting to be graded, Exam. When Review has nothing due it is greyed out. An Audience's People page opens from the Audience itself rather than from the sidebar.
- Gaps — owners of the Audience you are in only: its open questions, with a badge counting them. See The Gaps tab.
- 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 — Audiences, plus Conflicts if you own anything and Sources for org admins — and an Audience's surfaces become tabs across the top of its pages. For a learner those tabs are Chat and Lessons; for an owner, Chat, Lessons, Gaps, and People. The FAQ beside the conversation appears on wide windows only.
Learner home: Chat¶
Opening an Audience as a learner lands you on Chat, a multi-turn conversation grounded in your organization's sources, with the FAQ — the Audience's most-asked answered questions — listed beside it. The rest of the learner's Audience lives in the sidebar: Lessons, Review with a badge counting what is due, and Exam, which appears only once the final exam is unlocked, under way, or waiting to be graded.
Lessons¶
Lessons is the learner's overview page: everything composed for this Audience, grouped under the topic each entry explains, with the most-asked topics first and General — anything tied to no topic — last. When something is due for review, a Start reviewing card sits at the top, and a Lessons bar counts what you have finished out of what has been composed so far. A topic you have finished carries a check on its heading.
Opening an entry opens its article. While its lesson is outstanding, the article carries a Start the lesson prompt — Continue the lesson once you have begun — above and below the document, because the lesson is what the entry is asking of you. The entry shows where you stand: 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. An entry whose article has been commissioned but not yet written is greyed out and doesn't open. Looking something up mid-lesson is handled inside the exercise itself, which offers you the passage it was written from — see below.
Chat¶
Chat is the place for grounded questions in your own words, including follow-ups in the same thread. The FAQ beside it lists the ten most-asked answered questions with how many times each has been asked; clicking one drops the question and its recorded answer straight into the conversation, served on the spot. See Asking Questions.
The lesson player¶
You start a lesson from the prompt on its article. It gives you 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;
- Back to the article — above the lesson title. Your place in the lesson is kept, so you can leave for the document and pick up where you were.
Once you have finished every lesson in an audience, Exam appears in its sidebar with 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.
The article page¶
Clicking an entry opens its article: a single markdown document you read top to bottom. It is titled with its name, under the topic it explains, and — where it was written to answer a question somebody asked — it says which question.
Also on the article page:
- a position counter — 3 of 12 — showing where this entry sits in the list;
- a Start the lesson prompt — Continue the lesson once you have begun — above and below the document while its lesson is outstanding: an invitation, not a gate, with the whole article right there;
- links at the bottom to the previous and next entry, so you can work straight through them.
If you own an Audience¶
Owners (and org admins) get extra surfaces on the Audience. The Lessons page is the owner's authoring surface: every entry grouped by topic, filterable by picking topics, with an Ask for a lesson row for commissioning another. Curating an Audience is not the same as learning from it, so owners are not tracked as learners.
| Page | What it shows |
|---|---|
| Lessons | What this readership is told, which you author. Opening a lesson gives you the Article, the Lesson composed from it, and each learner's Progress on it. See Curating Contents and Curating Lessons |
| Chat's FAQ | The most-asked answered questions with their counts — the demand signal — each carrying Turn into a lesson. See Topics and Questions |
| People | Every learner in the Audience with their progress and status, the ones needing attention first, plus owners and pending invitations. See Monitoring Progress |
You read the articles you commissioned from the Lessons page, 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 other pages it stays a compact field at the bottom while you work.
Terms¶
Your organization's terminology reaches you where you need it, without your having to go looking. 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.
A term that names a topic works the same way: the panel shows its definition in place, and everything navigates back to the paragraph you were reading. The questions people ask about a topic live elsewhere — the most-asked answered ones in the FAQ beside Chat, where clicking one serves the answer into the conversation. See Topics and Questions.
If you want a definition and have no article in front of you, you can also ask for it on Chat.
Switching Audiences¶
If your admin has assigned you to more than one Audience, they all appear in the audience switcher in the sidebar — pick another Audience to switch. Each Audience is a completely independent experience: different Contents, different articles and lessons, and separate tracking.
Switching lands you on that Audience's Chat.
Deleting your account¶
Open the account menu at the bottom of the sidebar and choose Delete account. Deleting removes you from every organization you belong to and deletes your progress, notifications and registered devices. Articles, answers, and the facts you contributed stay with the organization.
Two things block deletion until you hand them over: being the only admin of an organization that still has other members, and being the only owner of an Audience. If you connected a source such as Google Drive or Slack for your organization, reconnect it under another admin first — deleting your account takes that connection and everything ingested through it.