Docs The app
Your turn and the Board
Every item in Turnkeel has a turn: who has to act next. Your turn lists what waits on you across every tab, and the Board arranges a project's cards by whose turn they are.
Whose turn it is
A turn is held by a person, an agent, a party (someone outside the workspace, such as Apple or a contractor) or "anyone who may" do an action, such as decide assets. It is worked out from fields the item already has.
| Item | Whose turn |
|---|---|
| Card | Its owner. A card that waits on a party is the party's; one that waits until a date returns to its owner on that date; one with an open blocker is with whoever holds the blocker. Done, archived and unassigned cards are nobody's. |
| Gate | Whoever it waits on, until it is passed or not applicable |
| Held gate change | Anyone who may confirm a gate change |
| Steps of a build | Each tester who has not ticked or written on a step, then whoever posted the build while there is feedback they have not read |
| Asset | Anyone who may decide assets, until it is approved and unchanged; its proposer while it needs changes |
| Post | Anyone who may approve posts, while it needs an OK or has failed; anyone who may mark it posted, once approved, when no webhook sends it |
| Decision | Anyone who may decide, while it is proposed |
| Inbox item | Anyone who may triage, while it is new |
| Listing | Anyone who may tick rows, until every row is done |
| Agent session | The agent's owner, while it needs you, failed or stopped reporting |
A date never changes whose turn it is. A due date is a plan: an overdue card waits on the same person as before, and says "Overdue, due 10 Nov". Overdue is counted in the workspace's time zone.
The Your turn view
Your turn is the home of a project: what waits on you, and under it, set quieter, what waits on everyone else. With All projects chosen in the project switcher it covers every project you may read.
Each line shows a kind label, the title, the key, who handed it over or last changed it, when, and one line of context, such as a card's newest status line. Lines are sorted by that time, newest first, so what was handed over last is on top. Priority and due dates do not sort the list. The header has a filter by kind, and lines load 50 at a time.
Three kinds fold into one line: the steps of a build ("N steps to test in build <title>"), the rows of a listing ("<title>: N left"), and a gate with its held change.
The number beside Your turn is the number of lines that wait on you, and each tab shows how many of its own items wait on you. A card with an open blocker is not counted; its blocker is. Releases, Money, Docs and Links have no turn and no count. When nothing waits on you, the page says "Nothing needs you right now."
Waiting on others
Under your list, grouped by who holds the turn: "Behind your own turn" (cards whose blocker waits on you), each agent, person and party, "Anyone who may …" for actions you may not take, "Until <date>", Blocked and Unassigned. Nothing in it asks anything of you.
The reading pane
From 1024 px wide, choosing a line opens its item in a pane beside the list. The pane is the item's own view from its tab, with the same actions and checks: a card opens as on the Board, a gate as in Launch. Below that width the item opens as its own page.
Nothing opens by itself; with no line chosen the pane says "Choose a line to open it here." When you act and the item stops waiting on you, its line leaves the list and the pane says whose turn it is now. The chosen line is part of the address, so a link can open it. Testers do not see Your turn; they land on Testing.
The Board
Rows are turn groups; columns are To do, In progress and Done.
| Group | Holds |
|---|---|
| Your turn | Cards you own |
| Team | Cards other people own, a row per person |
| Agents | Cards agents own, a row per agent |
| Waiting on someone else | Cards that wait on a party, until a date or on an open blocker |
| Unassigned | Cards with no owner |
To do and In progress keep one order for everyone. Done shows the newest six, with "Show older". A row shows the title, the card number, a pill naming who it waits on, the newest status line, priority when High or Low, the area, and, when the card has them, its due date, labels and checklist count ("3 of 5"). You can filter by person, agent, text, label, milestone and due date.
Moving a card
Drag a card to another column, onto Your turn or someone's row to give it to them, onto Unassigned to clear the owner, or between two cards to reorder it. Dropping it on Waiting on someone else asks "Waiting on whom, or until when?". A card blocked by an open card cannot be dragged out of Waiting. Every option is also in the "Move to…" menu, which is how it works on a phone and with a screen reader. A move shows on everyone's board at once.
The open card has its title and body, "Where it stands" with the newest status line, what it waits for and unblocks, its history, and the "Add a status line" box. Status lines are never edited or deleted; a correction is a new line. Typed text is saved as you type, and kept on the device until the server has it.
Other views of the Board
A view switch moves between Lanes (the board above), Calendar (cards, gates and posts on their dates, with milestones and the launch date), Timeline (milestones in date order, with how much of each is done) and Gantt (cards with a start and a due date as bars, with arrows from their blockers). Each view keeps the filters and shows who holds each item. None changes a turn.
Anyone who reads the Board can save a view with its filters under a name; a Member, Admin or Owner can share one with the project. An Owner or Admin can hide recurring cards, time tracking and the Gantt for the whole workspace; their data is kept.
The source of this page will be on GitHub when the repository opens. Something wrong or unclear? Write to us.