RabbinatixDocs
Sign inGet started

Work as a team

The board and tickets

Track work as tickets on one board: types, columns, tags and sprints, mentions that open the exact place, and the planning views.

Open Board in the app

What a ticket is

A ticket is one piece of work. It has a key such as TICKET-AUTH-001, a type, a column, assignees, tags, a priority, a due date, a checklist, links and comments. The key never changes, so you can use it in commits and code changes. Type it in the command palette to open the ticket from anywhere.

Every ticket opens in a drawer on top of the page you are on. The address gets ?ticket= and the key, so you can copy the link and share it.

The ticket view

  • Top: where the ticket sits (its type, its parent, its key), then the title and the actions: the type's own actions, Sub-task and Link. Top right: Discuss, More actions and Close. More actions has Open beside the list, Copy link (a link to the ticket), Copy as markdown and Delete ticket. Attach is in the Attachments section, where you can also drop files. A deleted ticket goes for everyone, with its comments and files; Undo on the message that follows brings it all back, and its history says restored it. After a few minutes its files and history are gone for good (tickets don't go to the Trash).
  • Previous and next: a ticket opened from the board shows where it is in the list ("3 of 42"). Previous ticket and Next ticket walk the board as it is filtered and sorted.
  • Left: who filed it, the description and the type's own fields (Hide details folds those fields away), then sub-tasks, attachments, the checklist, links, comments and history.
  • Links both ways: a link between two tickets shows on both. When TICKET-AUTH-001 blocks TICKET-AUTH-002, TICKET-AUTH-002 shows Blocked by TICKET-AUTH-001; Related shows on both, and Duplicates shows as Duplicated by on the other ticket. Click the key to open the other ticket. Anyone who can edit tickets can remove the link from either ticket, and both histories say so.
  • Right: the status, Deadlines when the ticket has a deadline policy, Details, More fields (folded), and Watchers and votes. A field looks like plain text. Click it to change it.

People who manage the board choose which fields show in Details: click Configure under the panel, add or remove fields, and put them in order. The fields left out fold into More fields. Custom fields from Settings → Tickets → Custom fields can go in either place.

Create a ticket

  1. Open Board in the sidebar.
  2. Click New ticket, or press c.
  3. Pick a Type and type a Title. If a similar ticket exists, the dialog lists it under Similar tickets: is it one of these?.
  4. Fill in what you need: Description, Systems, Assignees, Team, Due, Tags and Priority. A Template fills several fields at once.
  5. Click Create ticket.

Closing the dialog (×, Esc, a click outside or Cancel) after typing or picking something asks Discard this ticket? first; Keep editing goes back to it. If the tab reloads while you write, the next New ticket offers what you typed back.

You can also start a ticket from the object it is about. Right-click a system on the map, a flow step or a logic node and choose Create ticket…. The ticket is linked to that object, and the object shows a small dot or count while the ticket is open.

Ticket types

TypeUse it for
Task, BugEveryday work and defects
EpicA group of tickets, with progress rolled up from its tickets and sub-tasks
API requestAsking a provider for an endpoint. Moving it sets the endpoint's lifecycle
Flow request, Logic requestAsking for a new or changed flow or logic
Access requestAsking for a role or permissions
Broken contract, Failing test case and the other automatic typesOpened and closed by Rabbinatix. See automatic tickets

People who manage the board can add custom types, or hide built-in ones from New ticket, in Settings → Tickets → Ticket types.

Columns

The default columns are Requested, To do, In progress and Deployed. Each column has a category (new requests, to do, in progress or done). Automation reads the category, not the name, and tickets in a done column count as resolved.

  • Drag a card to move it. Press m to move the selected tickets with the keyboard.
  • Open a column's menu for Edit column…, Add column after, Move left, Move right, Hide in this view and Delete column….
  • Deleting a column asks where its tickets go. You can't delete the last to-do or done column.
  • An Endpoint lifecycle on a column sets the lifecycle of API requests moved into it.
  • A Max tickets in column only colours the header. It never blocks a move.

Tags and sprints

Type in the tag field and press Enter to make a tag such as backlog or tech-debt. A sprint tag has start and end dates, and only one sprint is active at a time. A sprint reads as you named it ("Sprint 6 · Launch fixes"); search finds it by its tag form, such as tag:sprint-6-launch-fixes. Manage tags in Settings → Tickets → Tags and sprints, where you can rename, merge, start and complete sprints. Completing a sprint asks where its open tickets go: the backlog or a planned sprint, which stays planned until you start it.

Type @ in a description, comment or checklist item to mention a system, contract, flow, a single step of a flow, a logic node, a test case, a run, a requirement or a member. The mention shows as a chip with live status. Clicking it opens exactly that place, for example a flow in the Logic view with the step selected. Mentioning a member makes them a watcher and notifies them.

To mention something from where it lives, right-click it and choose Copy mention, then paste it into a ticket.

Find tickets

The search box accepts words and a query language. Press / to focus it.

type:bug assignee:me priority:>=high is:open -tag:backlog sort:updated

The same field twice means either, different fields must all match, and - excludes. A value that names nothing there is says so under the filters, for example "No type called “bogus”.". Pick a built-in view (All tickets, API requests, My tickets, Active sprint) or click Save view to keep your filters, layout, grouping and sort. A view's own filters are said above the board ("This view shows tag ht-round"); the filter row adds to them. On a phone the filters fold behind one Filters button. Switch between Board, List and Split, add lanes, and choose Compact cards for long columns. Split lists the tickets on the left and shows the one you pick on the right. Press j and k to go to the next or previous ticket.

The other views

TabWhat it shows
My workAssigned to you, mentions, what you watch, what you filed, and Up next
BacklogOpen tickets outside any sprint. Drag them into a sprint, then Start sprint (before its start date, it asks first and the sprint starts today)
TimelineBars from start to due date, with arrows for blocking links
CalendarDue dates by month or week, with sprints as bands
ReportsBurndown, velocity, cycle and lead time, flow, aging work and missed deadlines
New requestsNew tickets to Accept, Decline, mark as Duplicate or Snooze

Import and export

Open the menu at the end of the board toolbar.

  1. Choose Import CSV….
  2. Pick a CSV file or paste the text. The first row must hold column names.
  3. Match each field to a column. Only Title is required.
  4. Click Preview and read the Problems column. Rows without a title, with a priority the board doesn't know or with a due date that doesn't exist are skipped, and the column says why. Another value that can't be read, such as an unknown type or member or an estimate that isn't a number, is warned about and left at its default.
  5. Click the create button to make the tickets.

Export CSV and Export JSON export the tickets in the current view. In the CSV, text that starts with =, +, - or @ gets a ' in front so a spreadsheet doesn't run it as a formula; importing the file takes it off again.

TipPress ? on the board to see every keyboard shortcut.