Docs-as-code migrations
Documentation migration to docs-as-code
This is for SaaS teams whose product docs live somewhere they no longer want them: a Zendesk help center, a Confluence space, a folder of Word files or a shared drive full of Google Docs. We move that content into Markdown in your own Git repository, published with Docusaurus, MkDocs, Zensical or GitBook, and we use the move to fix what went wrong along the way: duplicate pages, a navigation nobody can follow, and old links that still have to work.
From $4,500 (up to 150 pages), $9,500 (up to 500 pages), custom above
Reply within 1 business day
30-day fix window
Who it's for#who-its-for
- Heads of support who pay for a help center mainly to host articles, and want those articles versioned, reviewed and searchable like the rest of the product.
- Docs leads who inherited hundreds of pages across several tools, with competing versions of the same setup guide and no inventory of what exists.
- Engineering leads who want documentation changes to go through pull requests, previews and CI instead of a vendor's rich-text editor.
- SaaS executives heading into a launch, a security review or a new market, who need the docs to be one coherent site before more content piles on top.
If you are still weighing whether a move is worth it, the handbook page on deciding whether to migrate lays out the tradeoffs, including the cases where staying put is the right call.
What you get#what-you-get
The deliverable is a working documentation site in your repository, not a folder of converted files to finish yourself. Concretely:
- A content inventory of every source page, with a keep, merge, rewrite or retire decision for each one.
- A new information architecture: sidebar, categories and page types designed around the questions readers actually arrive with.
- Clean Markdown or MDX with frontmatter, converted from the source and edited by a person, not dumped by a script.
- Images and attachments moved into the repository with descriptive file names and alt text.
- A redirect map from every old URL to its new home, implemented on your host and tested before cutover.
- The site itself, configured with search, CI builds and preview deploys for every pull request.
- A short contributor guide, committed to the repository, so your team can publish without us.
On the target platform: Docusaurus is our default for teams that want React components, versioned docs and a site that matches the product. MkDocs suits teams that want plain Markdown and very little front-end work; since Material for MkDocs went into maintenance mode, we also look at Zensical, the new generator from the same team. GitBook suits teams that want a hosted editor for non-engineers with Git sync underneath. The platform comparison goes deeper, and we recommend one in writing during scoping.
How it runs#how-it-runs
- Scoping. You send read access or an export. We count pages, read a sample of the worst ones, and reply with a fixed quote and a recommended target platform.
- Inventory and architecture. We build the inventory and propose the new structure. Nothing moves until you approve the map.
- Conversion and cleanup. We convert, merge and rewrite in a branch you can review page by page, with a preview link for every change.
- Redirects and launch. We implement the redirect map, run link and redirect checks against the live URL list, and cut over with you on a day that suits your release calendar.
- 30-day fix window. For 30 days after delivery, anything we got wrong, such as a broken link, a missing image or a redirect that misses, we fix at no charge.
You get a short written update at the end of each stage, and any decision that changes what readers see comes to you first. Whoever scopes your project stays on it through delivery and the fix window, so the context never gets lost in a handoff and you always know who to ask when something looks wrong.
Pricing#pricing
- Up to 150 pages
- From $4,500
- about €4,150
- Up to 500 pages
- From $9,500
- about €8,750
- Above 500 pages
- Custom quote
The tier is set by the page count we agree during scoping, and pages we decide to retire rather than migrate do not count toward it. Above 500 pages, we quote the project after reading a representative sample.
What moves the price within a tier is how much work each page needs, not the page itself. A single, well-structured export converts quickly. Content spread across several tools, heavy rich-text formatting, custom macros, multiple product versions, or a large share of pages that need rewriting rather than converting all take longer, and the quote says so line by line. Prices are in US dollars; the euro figures are approximate conversions for reference.
Coming from a specific tool? The Confluence to Docusaurus and Zendesk to Docusaurus pages cover the details that are particular to each one.
Frequently asked questions#faq
Do you move content as-is, or rewrite it?
Will our search rankings survive the move?
Can our team keep publishing while you migrate?
What do you need from us?
Send us what you have
Send a link to your docs, an export, or a few lines on what needs to change. We reply within 1 business day with questions or a quote.