Connect Notion pages as a Source so Dosu can learn from your existing documentation, answer questions with citations back to those pages, and keep them current as your code changes. This page covers what connecting Notion gives you, availability and prerequisites, how to connect, and what Dosu does with the synced content.
Availability#
Notion is generally available and selectable in the app.
Notion requires the Teams plan (the Pro and Enterprise plans also include it), the same as Slack, Microsoft Teams, Confluence, and Coda.
What connecting Notion gives you#
Once Notion is connected as a Source inside a Library, Dosu can:
- Index the Notion pages you select so they can be searched and referenced.
- Answer questions in the Dosu app, on GitHub, and on Slack, with citations linking back to the relevant Notion pages.
- Generate Documents grounded in your Notion content alongside your other Sources.
- Keep imported documentation current, and write surgical updates back to a Notion page when code drift makes it stale.
Availability and prerequisites#
- A Dosu organization on the Teams plan (or Pro or Enterprise). For current plan details, see Plans, billing, and access or contact Dosu.
- A Library to hold the Source. Open or create one at Libraries.
- A Notion workspace you can authorize Dosu to read, and the pages you want Dosu to learn from.
How to connect#
- Open the Library you want to connect Notion to at Libraries, or create a new one at Create a Library.
- Add a Source and choose Notion.
- Authorize Dosu through Notion's OAuth flow, then grant access to the pages you want to connect.
- Save. Dosu begins indexing the selected pages.
After indexing, the pages are available to the people and coding agents that use this Library. For more on how Sources fit into a Library, see Sources and Libraries.
What Dosu does with it#
- Sync cadence. Notion is not real-time. Dosu polls connected Notion pages on a schedule, roughly every six hours, and re-indexes anything that changed. Edits you make in Notion appear in Dosu after the next sync, not instantly.
- Answers and writing. Dosu references your connected pages when it answers questions and when it drafts Documents, and it cites the Notion pages it drew from.
- Documentation that stays current. Import existing Notion pages and Dosu maintains them as your code changes. Import and manage these from Documents.
- Sync back. When a documentation change is accepted, Dosu can write the update back to the source Notion page. Your team approves drafts first in Review, so nothing changes without sign-off. See Knowledge reviews.
Notes and limits#
- Reconnect when prompted. If Notion authorization expires, syncing for that connection stops until it is reconnected, and answers and Documents can go stale in the meantime. Dosu emails organization owners and admins (and whoever connected it) when a reconnect is needed.
- Page scope. Dosu indexes the pages you grant during the Notion OAuth step. To add or remove pages later, update the connection's access in your Library.
- Web is different. Unlike Notion, a Web Source is never indexed or stored. Dosu reaches the web only at query time. See Web search.