How teams use NotionCandidly's Notion agents update product docs whenever its code changes
In a short video posted on Notion's YouTube channel on 11 November, a product leader at Candidly explains how the company uses Notion Agent Notion’s built-in AI assistant that can read your workspace, answer questions, and take actions you approve. to keep its product documentation in step with its Codebase All the source code that makes up a piece of software, usually kept in one shared place.. This is a Notion-made customer story, and the figures are Candidly's own.
What we learned
- To start, AI agent An AI program that can take actions for you, like writing code, filling forms or moving items, not just answering questions. filled in a 'product 101' template for each feature, guided by what the speaker calls 'codebase treasure maps' so the coding agent doesn't start from zero each time. Two people then reviewed and edited each document separately, to set a human-checked baseline.
- Now, every time code is merged into the main development branch, agents read the change and suggest edits to the matching documents as comments. People review only the Diff A view showing exactly what changed between two versions of a file or document., and their replies are logged so the agent can learn what it got right and wrong.
- Candidly says each product manager now spends about an hour and a half a week on documentation. Sales staff ask Notion questions, such as which Single sign-on A way to log in to many work apps with one company account. options are offered, and get answers that cite the docs and the code.
Why it matters: If your documentation always lags behind your product, the part to copy is the human-checked starting point plus reviewing only the changes. Start with one feature and keep a person approving every Suggested edit A proposed change to a Notion page that only takes effect after a person accepts it..
Sources (1)
- How Candidly uses agents to update product docs when code changes · NotionWatch ↗