Collaborative documentation your whole team can actually maintain
Writers edit visually, engineers work in git, and two-way GitHub Sync keeps everyone pointed at one source of truth.
Two kinds of contributors, one source of truth
Most documentation lives or dies on a simple tension. The people who know the product best are not always the people who are comfortable in a code editor. Your writers, product managers, and support agents want to open a page and start typing. Your engineers want to keep docs next to the code, in Markdown, under version control, reviewed like any other change. Force everyone into one workflow and half the team stops contributing.
OpenDocs is built for documentation collaboration between both groups at once. Non-technical contributors work in a visual block editor with no Markdown or git knowledge required — they see formatted pages, drag blocks around, and hit save. Engineers connect a GitHub repository and keep working exactly the way they already do: edit Markdown, commit to a branch, open a pull request. The difference is that these are not two separate copies of the truth that slowly drift apart. They are the same content, kept in sync automatically.
That is what makes team documentation sustainable. A support lead can fix a wrong screenshot caption in the morning, an engineer can update an API example that afternoon from their editor, and neither has to file a ticket for the other or paste changes across tools. The docs stay current because the people closest to each change can make it directly, in whichever surface fits how they work.
How collaboration works in OpenDocs
Writers and PMs in the block editor
The visual editor is where non-technical teammates live. Structured blocks, headings, callouts, and images — no syntax to learn. The AI Write Assistant helps draft, and the AI Writer Improver tightens tone so many hands still read like one voice.
Engineers in Markdown and git
Connect a GitHub repo and engineers stay in their normal workflow. Pages are stored as Markdown with YAML frontmatter, so docs live beside the code, get reviewed in pull requests, and travel with every release — true docs-as-code, no new tools to adopt.
GitHub Sync keeps both honest
Two-way sync ties the editor and the repo together. Editor saves commit Markdown back to GitHub; pushes to the repo update your pages. When both sides change the same page, conflict detection flags it with a side-by-side comparison so nothing is quietly overwritten.
Spaces and members: structure without per-seat friction
Collaboration needs boundaries, and in OpenDocs those boundaries are spaces. A space is a self-contained set of documentation — a product, a help center, an internal handbook — with its own navigation, theme, and access rules. Splitting your docs into spaces lets different groups own different areas without tripping over each other, and it keeps published content cleanly separated from work that is not ready yet.
Adding people to that work should never be the expensive part, which is why OpenDocs uses flat tiers with members included rather than charging for every seat. Pro is $55/month and includes 5 members. Enterprise is $99/month and includes 10 members. When your team outgrows the included count, extra members are a modest flat add-on — $5/member/month on Pro monthly billing (or $4/member/month billed annually) — so you can grow to an effectively unlimited number of collaborators without a bill that lurches upward every time someone joins.
The contrast with per-seat documentation tools matters most for the contributors who edit occasionally. On a per-seat model, the support agent who fixes one page a month and the reviewer who signs off on a release both cost a full recurring seat, so teams end up rationing access to save money — which is exactly how docs go stale. With members included in a flat tier, adding an occasional contributor is cheap or free, and readers of your published documentation are never billed at all.
The GitHub Sync workflow, in detail
GitHub Sync is the mechanism that lets a visual editor and a git repository stay in agreement. You connect a space to a repository with a GitHub Personal Access Token, and from then on changes flow both ways automatically. It is available on every plan, including the free trial — there is no tier gate on keeping your team in sync.
- GitHub to OpenDocs. When someone pushes a commit, a webhook fires. OpenDocs fetches the changed
.mdfiles and updates the matching pages, so an engineer editing Markdown in their own tooling sees the published docs update without touching the app. - OpenDocs to GitHub. When a writer saves a page in the block editor, OpenDocs commits Markdown back to the repository through the GitHub Contents API, with YAML frontmatter carrying the title, slug, order, and parent so structure survives the round trip.
- Conflict detection. If the same page was changed on both sides, OpenDocs does not guess. It flags the conflict and shows a side-by-side comparison, and you decide which version wins — the safeguard that makes two-way editing trustworthy on a real team.
The result is a genuine docs-as-code story that does not exclude anyone. Engineers get version control, pull-request review, and docs that ship with the code. Writers get a page they can edit without learning git. And because both edit the same synced content, there is only ever one source of truth to keep current.
Consistent voice across many authors
The hidden cost of team documentation is drift in tone. Ten contributors naturally write in ten registers, and a docs site that reads like a committee undermines trust in the content. The AI Writer Improver is built for exactly this — run it over a page and it tightens phrasing and smooths tone so contributions from across the team land in a consistent voice, without a single editor becoming the bottleneck for every change. Like all AI features it is BYOK: you bring your own Anthropic API key and usage is billed through your Anthropic account, on every plan.
Restricted spaces for drafts and internal work
Not every collaboration is meant for the public. A space can be public, serving readers who need no account, or restricted for private docs your team is still working on. Restricted spaces are where drafts, internal runbooks, and pre-launch documentation come together — the team collaborates in the open internally, then publishes to a public space when it is ready. Keeping the two separate means work in progress never leaks to readers, and published docs never get cluttered with half-finished pages.
What collaboration means here (and what it does not)
It is worth being precise, because "collaborative" gets stretched to mean a lot of things. OpenDocs does not offer live cursors or Google-Docs-style simultaneous editing of a single page. Two teammates do not watch each other type in real time. If that specific experience is what you need, OpenDocs is not the right tool and we would rather say so plainly.
What OpenDocs does give a team is a durable way to build documentation together: clear roles and member management, a git workflow through GitHub Sync that lets technical and non-technical people contribute in their own way, conflict detection when edits collide, and a reader feedback loop that turns your audience into another set of eyes on accuracy. That is collaboration measured in a docs site that stays correct as it grows — not in blinking cursors.
Flat tiers beat per-seat as your team grows
Documentation collaboration gets more valuable with more contributors, so a pricing model that punishes you for adding them works against the whole point. Many documentation and workspace tools charge per seat, and the invoice scales linearly with headcount — every writer, editor, and occasional reviewer is another recurring line item. OpenDocs uses flat tiers with members included, so a growing team does not automatically mean a growing bill.
Pro is $55/month (or $45.65/month billed annually, $547.80/year) with 5 members included. Enterprise is $99/month (or $82.50/month billed annually, $990/year) with 10 members included. Beyond the included count, extra members are a flat add-on, and you can grow to an unlimited number of collaborators. Enterprise adds analytics, PDF and Markdown export, API access, SSO/SAML, audit logs, and priority support for organizations that need them.
Collaboration cost at a glance
| Cost factor | OpenDocs | Typical per-seat tools |
|---|---|---|
| Pricing model | Flat tier, members included | Per seat |
| Team tier | $55/mo — 5 members included | Scales with every editor added |
| Adding an occasional contributor | +$5/member/mo (+$4 annual) | A full recurring seat |
| Readers of published docs | Not billed (public or restricted) | Varies; often gated |
| GitHub two-way sync | Included on every plan | Often higher tiers only |
Frequently asked questions
What is collaborative documentation?
Collaborative documentation is documentation that a whole team maintains together rather than one owner. In OpenDocs that means writers, product managers, and support agents edit in a visual block editor while engineers work in Markdown and git, and two-way GitHub Sync keeps both sides pointing at one source of truth. Roles, review, and a shared feedback loop replace the copy-paste handoffs that let docs drift out of date.
Can non-technical writers and engineers work on the same docs?
Yes, that is the point. Non-technical contributors use the visual block editor with no Markdown or git knowledge required. Engineers connect a GitHub repository and work in Markdown with YAML frontmatter from their normal branch-and-commit workflow. Every page save syncs in both directions, so both audiences edit the same content without stepping on each other.
Does OpenDocs support real-time co-editing like Google Docs?
No. OpenDocs does not offer live cursors or simultaneous multi-person editing of a single page. Collaboration here is built on roles and member management, the git workflow through GitHub Sync, and a reader feedback loop, with conflict detection when two people change the same page. If you need Google-Docs-style live co-authoring, OpenDocs is not that tool.
How does GitHub Sync handle conflicts when two people edit the same page?
When the same page changes in both the OpenDocs editor and the GitHub repository, OpenDocs flags a conflict instead of silently overwriting. It shows a side-by-side comparison of the two versions so you can see exactly what differs and choose which one to keep. Nothing is lost automatically, which keeps writers and engineers honest about who changed what.
How many team members are included, and what does it cost to add more?
Pro is a flat $55/month and includes 5 members; Enterprise is $99/month and includes 10 members. Extra members are a flat add-on ($5/member/month on Pro monthly billing, less annually), so you can grow to an unlimited number of collaborators without per-seat pricing that jumps every time someone joins. Readers of your published docs are never billed as seats.
Can I keep drafts and internal docs private while a team works on them?
Yes. A space can be public or restricted. Restricted spaces are ideal for drafts, internal runbooks, and work in progress that your team collaborates on before anything is published, while public spaces serve readers who need no account. You control access at the space level, so collaboration and publishing stay cleanly separated.