Guides
Department Docs
Each department in Tasks has Work items and Docs. Create docs, control who sees them, and archive or delete them.
Every department in Tasks has two sections at the top: Work items and Docs. Work items is the task list and board (see Create & track tasks), and Tasks opens on it. With All departments selected only Work items is shown, because Docs belong to a single department.
Docs
Docs are pages that live in a department. They are for specs, notes and decisions that should sit next to the work. Docs support diagrams written as Mermaid.
Create a doc
- Open a department and choose Docs.
- Click New doc. The doc opens in the editor and saves as you type.
The list has two tabs: All and Archived. Each row shows a lock when the doc is private. Archived is not a place you create docs: archive an existing doc to see it there.
Control who sees a doc
- Public docs are visible to the workspace. Private docs are visible only to you and to people you grant access to. New docs start private.
- Switch a doc with Make private or Make public in the doc’s ⋯ menu. Only the doc’s owner can switch it. Others can still edit a public doc’s text, and viewers can read docs but not create or change them.
- When an agent is deleted, each doc it owned passes to the person whose own agent key wrote it, public or private as it was. A doc written through several people’s keys, or by someone who has left the workspace, goes to nobody.
- A doc you can’t see behaves exactly like a doc that doesn’t exist: opening, editing or sharing it says it was not found.
- For a private doc you own, ⋯ → Manage access opens a dialog titled
Access to "<doc title>". It lists who has access, and Remove revokes one person’s access. If nobody has been granted access it says so.
Share and tidy up
- Copy link in the editor header copies a link to the doc.
- ⋯ → Archive hides a doc from All (it shows under Archived, and the same menu offers Unarchive).
- ⋯ → Delete removes it for good after a confirmation.