Developer docs
Workflow recipes: integrations working together
Each recipe chains a few integrations around one review. Changes always come in as a draft or proposal, and nothing goes live until a person approves it.
Every integration has a short tour: in the app, open Settings → Personal → Guides and tours.
Engineering on GitHub and Slack
For: Engineering teams who ship code against written specs.
- Open a proposal on the spec and add the Jira or Linear issue under Linked issues.
- Slack posts the review request in the channel you picked for the workspace.
- Reviewers approve, then the proposal is published as the new Current version.
- The GitHub check flags pull requests that still cite the old spec version.
- The GitHub repo mirror rewrites the spec as Markdown in your repo.
- Jira or Linear gets a comment on the linked issue saying the spec was published.
What changes for the team: Engineers build against the approved spec, and code review catches stale references before merge.
Docs and tours: Jira (tour) · Linear (tour) · Slack (tour) · GitHub (tour)
Writers in Word or Google Docs
For: Writers and reviewers who draft in Microsoft Word or Google Docs.
- Install the Microsoft Word add-in or the Google Docs add-on and sign in.
- In the add-in, search a document and open its approved version, or link the file you have.
- Edit as usual, then click Propose changes to send your edits for review.
- Reviewers comment and approve in VersoDocs, and a person publishes.
- Everyone with the file open sees a notice when a newer approved version exists.
What changes for the team: Writers stay in their editor, and the team still has one reviewed, approved version.
Docs and tours: Microsoft Word (tour) · Google Docs add-on (tour)
AI agents that read and propose
For: Teams who use Claude, Cursor or Copilot alongside their specs.
- Each member connects their agent in one click under Personal settings → Your AI agents (MCP).
- The agent reads only the Current version, or uses Ask your docs for answers with citations.
- When something is out of date, the agent opens a proposal with its suggested edits.
- The AI reviewer posts a first pass, then people review and approve.
- A person publishes, and every agent reads the new Current version.
What changes for the team: Agents help draft and check, but every change is approved by people before it goes live.
Docs and tours: Your AI agents (MCP) (tour) · AI assistants (tour) · AI reviewers (tour)