Collaborative Editing
Multiple people can edit the same spec page at the same time. Changes appear in real time for everyone — no refresh needed, no conflicts, no version control headaches.
How it works
Section titled “How it works”When you open a spec page, you automatically join the live editing session for that page. If other team members are already there, their cursors appear in the document, colour-coded by user.
Every keystroke is synced instantly. Two people can edit different paragraphs simultaneously, or one person can type while another watches — the document stays consistent for everyone.
Who can edit
Section titled “Who can edit”Only Providers can edit the text content of a spec page. Clients can read and navigate the page, and can use @mentions, but the editor is read-only for them.
This keeps the spec as the Provider’s responsibility — Clients provide direction and approval, not direct edits to the working document.
Real-time vs saved state
Section titled “Real-time vs saved state”The real-time session and the saved document are the same thing. There is no “publish” step. What you see is what everyone sees, and it is always saved.
Presence indicators
Section titled “Presence indicators”At the top of an open spec page, you’ll see avatar icons for every person currently viewing the page — Providers and Clients alike. This tells you who is in the document right now, useful when you want to know if a Client is actively reading something you’ve just written.
When to use it
Section titled “When to use it”Real-time collaborative editing is most powerful for:
- Working sessions — Provider and Client editing a spec together on a call
- Rapid iteration — two Providers simultaneously structuring a large feature area
- Live review — walking through a spec page with a stakeholder while both can see the same view
For async review cycles, use mentions and notifications instead.