RabbinatixDocs
Sign inGet started

Work as a team

Pages and spaces

Write your project’s knowledge (overviews, decisions, runbooks, how-tos, meeting notes) in spaces, with live links to systems, flows, logic and tickets.

Open Pages in the app

Spaces and pages

Pages in the sidebar lists the project's spaces. A space holds a team's or a topic's pages, such as Engineering, Runbooks or Product. Each space has a short key, and its pages are numbered with it: the space Engineering with the key ENG has the pages ENG-1, ENG-2 and so on. The first page of a space is its home page.

Pages nest: a page can have child pages, as deep as ten levels. The tree on the left of a space shows them all. Fold and unfold a page's children with the arrow in front of it, and type in Find a page by title, or label:runbook to find a page by its title or its labels (a page made from the Runbook template has the label runbook, and so on for each built-in template; Search at the top finds words in the text). On a phone, Pages in this space at the top of a page opens the same tree.

Who reads and who writes

A space is open to everyone in the project, or limited to some people. Nobody else sees a limited space or its pages, not even in search or through a link. Choose this when you create the space, or later in its settings.

  • Everyone who reads a space reads its pages, comments on them and watches them, viewers and auditors included.
  • Write pages (a permission in Settings → Roles) lets people create, edit, publish, move and delete pages. Developers, project owners, QA, admins and owners have it.
  • Manage spaces lets people create spaces, change who opens them, archive them and delete them. Project owners, admins and owners have it.

An archived space stays readable, but no new pages go into it.

To delete a space, open its settings and press Delete space…, or use Delete space… in the more menu of its home page. It asks first. The space and every page in it go to the trash as one entry, with their history and comments; restore it from Trash for 30 days and it comes back whole. Only owners and admins (whoever manages spaces) delete a space.

Create and organize pages

  • Create page at the bottom of the tree adds a page at the top of the space; Create child page in a page's more menu adds one under it. Start from a blank page or a template: Project overview, Meeting notes, Decision record, Runbook, How-to, Incident review or API guide, or one your workspace saved with Save as template….
  • Drag a page in the tree: drop it on the top edge of another page to put it before, on the bottom edge to put it after, or on the middle to put it inside.
  • Without a mouse, use the page's menu in the tree, or the more menu on the page: Move… picks a space and the page to put it under. Its child pages go with it, and keep their keys.
  • Rename… changes a page's title. Labels… adds labels, so pages can be found by them.

Write a page

Edit opens the page in the editor. One person edits a page at a time: while someone does, the page says "<name> is editing" next to Edit, and anyone else who opens the editor sees who it is. If that person has left it for more than 15 minutes, you can take over; their draft stays theirs, and their editor closes and tells them you took over. When you're done, it opens for them again.

  • Type as in any word processor. Markdown shortcuts work too: # for a heading, - for a list, [] for a checklist, three back ticks for code.
  • Type / for the blocks: headings, lists, checklists, quotes, callouts (Note, Tip, Warning, Decision), code, tables, dividers, pictures, Embed, Tickets, Child pages and Contents.
  • Type @ to link a system, an API, a flow, a logic, a whiteboard, a ticket, a person or another page. The link shows its current name and status, so it never goes out of date. Embed shows the same as a card.
  • Tickets shows the open tickets of a shared board view, live.
  • Paste or drop a picture to add it.

What you type is kept as your draft a moment later; nobody else sees it. Done leaves the editor and keeps the draft for later. Publish makes it the page everyone reads, with an optional note about what changed. If someone else published since you started, you are asked before yours replaces it. Discard draft throws your changes away.

History

The version under the title opens the page's History: every version of the last hour, one an hour for a day and one a day after that, with who published it and their note. Read any version as it was, Compare it with another line by line (the text as it reads, a picture as "[picture: name]"), or Restore as a draft to bring it back: publishing it makes it the newest version, so nothing is lost.

Comments and tickets

Comment at the bottom of a page, or select some words and choose Comment to comment on them. An inline comment shows the words it is about, and says so when the text has changed since. Answer, resolve and reopen comments; mention people with @.

  • Create ticket on a comment makes a task linked to the page. When the ticket is done, the comment is resolved.
  • Select a sentence and choose Create ticket to make it a task, quoting the sentence.
  • Tickets about this page lists the open tickets that link to it, and Pages that link here the pages that link to it. A ticket shows the pages that link to it too.

Find, watch and share

  • Press Ctrl+K (Cmd+K on a Mac) and type a word of a page's title or text to find it.
  • Watch tells you when the page is published again or commented on. You watch the pages you create, publish or comment on without asking.
  • The more menu downloads the page as Markdown or PDF.
  • An AI assistant connected in Integrations can search the pages you read and read them whole.

Delete and restore

Delete… sends the page, its child pages, its history and its comments to the trash. Restore them from Trash for 30 days. A space's home page can't be deleted on its own: delete or archive the space instead. Owners and admins (whoever manages spaces) delete any page; a Developer deletes only the pages they created, and not one with someone else's page under it.