Glossary
These are the words Brownpaper uses on the board and in its menus, grouped by topic and in alphabetical order within each group.
Board and views
2D
The board as you build and adjust it: cards in lanes, with arrows between them. It’s the same board as in 3D and BPMN, so a change in one view shows up in the others.
3D
The board as a hall. Each step is a workstation on the floor, each lane is a strip of the hall, and the arrows are cables. A light above a workstation means there’s a bottleneck there or a question is open.
Arrange
Tidies the whole board up again, in 2D and 3D. If you dragged something by accident, it goes back into place, and Ctrl+Z restores your own layout. The button is called Arrange.
Board
The diagram Brownpaper draws: lanes for roles, cards for steps, arrows between them, plus bottlenecks and risks. You see the same board in 2D, 3D and BPMN.
BPMN
The international notation for processes. Brownpaper converts your board to it automatically, with tasks, gateways and events. Click an element to open the panel of that card or arrow. To use it in other process tools, download it as a .bpmn file under Download.
Example board
A complete board with its conversation, for looking around. You can’t change it; to work on your own, start a board of your own. You’ll find it in the sidebar under Example board. You can’t make a view link or a report from it.
Layer
A layer is something on the board that you switch on or off under View. The cards stay the same. The layers:
- Bottlenecks on the cards
- Times
- System on the card
- Text on the arrows
- Notes
Legend
The panel that explains what you see: shapes, arrows, signs, systems and bottlenecks. Click a shape, a system or a bottleneck to show only those steps, and use the arrows to step through them. The pencil next to a system renames it on every step at once. If you pick a name that already exists, the two systems merge. Show or hide the legend with Legend under View.
Origin
Everything on the board can be traced back to something that was said. A card that came from the conversation points to the passage behind it: hover over the card, or click it, and the conversation jumps to that turn. The panel of a card or arrow also shows who added it.
Sub-board
A step can have a board of its own that works it out in detail. Open it with the small tab under the card. In its panel, a card with a sub-board is called Process, and it shows what’s on the sub-board. If you can see a board, you can also see the sub-boards under it, with the same rights.
View
A view is the question you look at the board with. The cards stay the same.
- Process: who does what, in which order.
- Systems: which system it happens in, and where it crosses a system boundary.
- Data: which data goes where, and where it’s retyped.
- Bottlenecks: where it hurts.
On the board
Arrow
The line between two cards. There are three kinds:
- Sequence: the normal next step.
- Exception (dotted): a route that’s only taken sometimes.
- Rework (dashed): the work goes back to redo something.
If two arrows leave one step, both happen at the same time. Only a decision picks one path. The arrow out of a decision shows the outcome and, where it was mentioned, the share of cases that take it. To draw an arrow yourself, drag from the dot on the edge of a card to another card.
Bottleneck
A bottleneck is a flag above a card, with its kind inside. Someone said it, or it follows from the board, such as data that’s retyped between two systems. That second kind is a white flag with a dashed outline. The kinds:
- Sits waiting: the work stands still because nobody gets to it.
- Waiting on others: someone outside your control has to act first.
- Batched: work waits until there’s enough of it, or until a fixed time.
- Retyping: data is retyped by hand between paper, email and systems.
- Two systems: two systems aren’t connected, so someone has to move data from one to the other.
- Rework: something has to be redone, or goes back to an earlier step.
- Searching and chasing: looking for information.
- Checking: checking, signing off or approving what’s already there.
- Manual work: doing by hand what a system could do.
- Unclear who: nobody’s sure who does the step or decides.
Card
A card is one shape on the board. The shape tells you the kind, and the lane tells you who does it. Double-click a card to open its panel. The kinds:
- Start: where the process begins, with a message or at a fixed time (Message or Time).
- Step: something someone does.
- Decision: a choice. The arrows show the outcome, each in its own colour.
- Wait: the work stands still, usually for a set time.
- End: where the process stops.
Contradiction
Two accounts of the same step that can’t both be true. It doesn’t count as a bottleneck. It’s a question, and it’s listed separately.
Control
A shield on the step that prevents or detects a risk. A control is preventive or detective, manual or automated, with a norm and a frequency. One control can cover a risk elsewhere on the board.
Data item
What a step needs or produces. Each data item shows which part of the conversation it comes from and how it arrives: retyped, automatic, or not said yet. Follow them across the board in the Data view.
Handoff
The moment work passes from one role or system to another. Brownpaper asks how it passes: by email, in a system or on paper, and whether someone retypes it or it comes along automatically. Retyping is itself a kind of bottleneck. In the Data view you can see where data is retyped.
Lane
A lane is a strip for one role. A step sits in the lane of whoever does the work. Drag a step to another lane and it takes that lane’s role. A start, end or decision has no role: drag it into a lane and it stays there; otherwise it sits in the lane of the card before or after it. To rename a lane, click its name.
Lead time
How long a step takes from start to finish, including waiting. On the card it’s labelled takes.
Note
A note beside the process: a question, or something to look into. A note is yellow, blue or pink and isn’t a step. It stays when the board carries out an instruction. A comment is something different.
Own list
A system that’s really a list someone keeps for themselves, like their own Excel sheet. The system name then carries “own list”. You tick it yourself in the step’s panel, under the system.
Process time
How long someone actually works on a step, not counting waiting. On the card it’s labelled work. If two of these three are filled in (process time, how often, and the total), the board works out the third.
Risk
A risk is a triangle on a card: what can go wrong and what follows, with a quote if one was given. A risk that no control covers stands out, marked Not covered.
System
The program a step happens in. It’s shown at the top of the card, each system in its own colour. If there’s none, nobody said which system it happens in. You can rename it in the legend, for all steps at once.
The conversation
Chat
The third tab, next to Conversation and Guide. Ask what was said or how the process could be better, and the answer points to cards. The chat only discusses this board, never writes on it, and is private to you. It costs credits.
Conversation
The panel next to the board that shows what’s being said, with Guide and Chat as tabs. When you start, you pick a mode: listen-in or interview. You can always type too.
Final round
The last phase of the guide: whatever is still open outside the chosen topics, in the same order. Your aim decides what comes up first. Nothing gets dropped.
Guide
The tab next to the conversation that shows which phase the conversation is in and what hasn’t been covered yet. The phases, in order:
- Start and end
- The main route
- Choices and exceptions
- Data and handoffs
- Time and what goes wrong
- the final round
Intake
What the conversation is about: the name, the subject, where it starts and ends (Starts at and Ends at), who works on it, which systems are involved and what you want to find out. Brownpaper draws nothing outside the start and the end. Nothing is fixed: you can change the intake later with Adjust intake.
Interview mode
One of the two conversation modes: you do the talking, and Brownpaper listens and asks follow-up questions where something’s missing. If you type a question, you get an answer straight away. On screen it’s called Interview mode.
Interviews
An invitation that lets someone describe their work through a link of their own, without an account. Brownpaper asks the questions and builds the board from the answers, on a separate copy. You can see how far each person has got. The screen is called Interviews.
Listen-in mode
The other conversation mode: you hold the conversation the way you normally would, and Brownpaper builds the board quietly as you talk. It also works in an online call. On screen it’s called Listen-in mode.
Recheck
A round where Brownpaper goes back through the whole conversation, every so many processed turns. It straightens out what’s hard to spot turn by turn, such as duplicate steps. If the board has come apart, it redraws it from the whole conversation. Anything you made or changed yourself stays. It takes a few minutes, and you can keep talking.
Recording
A recording of a conversation, as video or audio, that you upload. Brownpaper transcribes it first. You’ll find it under Recordings, where you choose Make board.
Spoken language
The spoken language is the language people speak in. Speech recognition, the voice and everything on the board use it. You choose it per board in the intake and change it with Adjust intake. A new language applies from the next time the microphone goes on.
Transcript
The written text of a conversation that has already taken place. You paste it or choose a file, and Brownpaper reads it first and only draws when you say so.
Analysis and changes
Analysis
Brownpaper reads the whole conversation again and looks for where the time goes and what can go wrong. Everything it finds goes onto the board in one go, and one Ctrl+Z takes it off again. You start the analysis under AI › Analysis. It costs credits.
Comment
A remark on a card, an arrow, a note or the whole board, left for Review. A comment is never on the board itself. Under Download and Share you choose whether to include comments; by default they’re left out. Process the comments turns them into a proposal.
Instruction
A request to the board in plain words, such as “turn this into eight main steps”. You start it under AI › Instruct the board. Afterwards Revert appears above the board. It undoes the instruction, even if you’ve added something since.
Log
Click What Brownpaper is doing to open the log: every step on the board, with who did it and what came out of it. Click a line to go back to that point. A grey line has been undone; click it to go forward again. If the last round failed or produced nothing, you’ll see Try again.
Revert
A button that undoes an instruction, an applied Simplify proposal or a processed batch of comments in one go, even if something was added afterwards. For a sub-board you unlinked, Put it back hangs it back under its step.
Review
The panel where you fill in what’s missing and leave comments. Brownpaper turns the comments into a proposal, and you tick what goes ahead. Open it with Review, the speech bubble next to the pencil.
Simplify
Brownpaper reads the conversation and the board and proposes what could be simpler: merging steps, unifying two names for the same system, removing a detour. You get a numbered list with the reason for each point. Untick what you don’t want and press Apply. You’ll find it under AI. It costs credits.
Status indicator
The indicator at the top centre, next to AI, called What Brownpaper is doing. On the left you see whether Brownpaper is listening or speaking. On the right is an icon for each running job, then what the last round produced, such as “+3 cards” or “Nothing changed”. Click it to open the log. Turn it off under View.
Undo
Ctrl+Z reverts the last action, even if Brownpaper did it. Ctrl+Y puts it back. A recheck round, an instruction, the analysis and Simplify are each undone in one go, not card by card.
Sharing and exporting
Project link
One link for someone without an account, covering all the boards in a project, for viewing only. Only the project’s maker can create and manage it. Boards added to the project later show up automatically.
Report
A plain-language text about the board, written by Brownpaper, as PDF, Word or Markdown. It’s the only export that costs credits. Afterwards you’ll find it under Exports.
View link
A link for someone without an account. They can view the board and its sub-boards, in 2D, 3D or BPMN, but can’t change anything. Only the board’s maker can create and revoke it, with Make and copy view link.
Organisation and account
AI connection
The link between Brownpaper and an AI assistant such as Claude, ChatGPT, Gemini or Copilot. The assistant works for you in one organisation and sees only what you can see. To disconnect, go to Settings › Connect AI. It takes effect immediately.
Credits
Everything Brownpaper does with AI comes out of your organisation’s credits: listening in and interviewing, drawing from a transcript or recording, instructions, the analysis, chat, Simplify, the report and house rules. Looking, drawing by hand and most exports are free. Your balance is at the bottom of the sidebar.
House rules
The rules for how your organisation names and draws things. You paste them as text under Settings › Organisation. Brownpaper picks out the rules the board can show and follows them on all your boards.
House style
The house style sets how the app, the boards and the exports look: colours, fonts, the frame around the board and the logo. Bottlenecks keep their own colour. House rules are about words, house style is about looks.
Interface language
The language of the buttons, menus and messages. You choose it yourself, in the account menu or under Settings › Profile and privacy. So a board in English can sit in a Dutch interface.
Organisation
The group that boards, members and credits belong to. Every member has a role: Owner, Admin or Member.
Project
A folder for boards, per client or engagement. Boards outside a project are under General. If a project is shared with you, you see all the boards in it.