Project docs

Living markdown documentation attached to each project, editable by the whole team.

Project docs are notes, specs or any markdown documentation that hangs off a project.

What it is

A project tab with a master-detail interface: the list of documents on one side and the editor on the other. Each document has a title and a markdown body.

What it’s for

Keeping collaborative documentation where the work lives. Any workspace member can create, edit and delete documents (there’s no exclusive authorship).

How to use it

  • New creates an untitled document; edit the title inline and the body in the markdown editor.
  • Changes save themselves (local-first, optimistic): there’s no save button.
  • Delete shows an Undo prompt for a few seconds; if you don’t undo, it’s removed.

Details

  • The list is ordered by position and, on ties, by creation date.
  • On mobile, the list moves to a side panel to give the editor full width.
  • Deleting the project also removes its documents.

Related: Projects · Project templates.