Create the new key first, deploy it, then revoke the old one.
cited · docs/api/authentication
We write into the tools you already use
Mintlify
GitBook
Docusaurus
ReadMe
Notion
Zendesk
Start here
Documentation is your product, explained in writing.
Your team already knows how the product works. Most of it lives in people’s heads, old Slack threads and support replies, so it gets explained again every time somebody asks.
We write it down once, properly, and keep it that way. Product docs, developer docs and help centres for SaaS and API-first companies.
You get a documentation site, not a hiring problem.
The cost, drawn out
Where the same question ends up, before and after.
One customer, one question, two versions of your company. The difference is not effort. It is whether the answer was written down once.
Today
Three people. Nothing written down.2 to 4 days
Every answer is written from scratch, by someone senior, and then lost in a thread. The next person asks the same thing next week.
What you gain
Outcomes you feel within a quarter
Fewer repeat tickets
The questions your team answers most become pages, and stop coming back.
How do I rotate a key?
Where are rate limits?
Faster onboarding
Customers and developers reach their first success without a meeting.
day 1
One version of the truth
Sales, support and engineering describe the product the same way.
sales
support
eng
one page
Readable by AI
Assistants answer from your words instead of inventing their own.
“Rotate the key, then redeploy.”
cited: docs/api/authentication
Findable in search
Docs pages rank for the specific problems buyers type into Google.
paperkraft.co › docs › webhooksWhy a webhook fires twice
Shorter sales cycles
Technical buyers evaluate you at their own pace, before the first call.
evalsigned
Why this matters
Your docs answer more questions than your team does
When something breaks, people ask an AI before they open a ticket. What it tells them comes from your docs, or from a guess.
Endpoint references, authentication, errors, rate limits and working examples, written so a developer can integrate without asking you a single question.
Pipelines that keep pages in step with your releases, so docs stop drifting out of date.
How we work
Our process
Step 1
Human-led
Discovery Call
A 30-minute call on your product, your support queue and whatever docs exist today. You leave knowing what is worth writing first.
30 minutes
top 20 tickets
14 gaps found
Step 2
Human-led
Strategic Outline
We agree on the map before a word is written: what pages exist, who each one is for, and where a reader lands first.
Get started
Guides
API reference
Troubleshooting
Step 3
Human + agent
Accurate Writing & Testing
Agents draft from your code, your tickets and your release notes; we rewrite what they get wrong and follow every instruction ourselves on a clean setup.
draftHandling duplicate webhooks
tested9 of 9 steps reproduced
Step 4
Human-led
Design & UX
Navigation, page layout, code samples and search. So the reader gets to the paragraph that answers them, not just the right page.
Step 5
Human + agent
Reporting & Delivery
Published into your own setup. Agents watch your releases and flag the pages a change just made wrong, so nothing quietly goes stale between reports.
v2.2v2.3v2.4 docs shipped same day
How the work gets done
Agents do the sweeps. People make the calls.
We are not typing your docs out by hand, and we are not letting a model publish straight to your domain either. Machines do the work that is mechanical and endless; the judgment stays with the people who own the outcome.
Agents
Read the codebase, the OpenAPI spec and the ticket queue
Draft first passes and keep examples in step with the API
Diff every release against the pages it just made wrong
Run link, build and code-sample checks on every change
People
Decide what is worth writing, and what to leave out
Rewrite anything that reads like a machine wrote it
Follow every instruction on a clean setup before it ships
Sign off. Nothing reaches your domain unread
The basics
Start with the obvious questions
Read it the way you would read a docs site: pick a page on the left.
Basics
docs / basics / what-are-docs
What is documentation?
Documentation is your product explained in writing: what it does, how to set it up, what each screen and each API call means, and what to do when something breaks.
Every company already has this knowledge. Most keep it in people’s heads, old Slack threads and support replies, so it gets explained again and again, slightly differently each time.
In practice
If a customer or a developer can ask it, there should be a page that answers it.
docs / basics / why-docs
Why does a product need docs?
Because the same questions arrive every week, and answering them by hand does not scale. A written answer is read hundreds of times; a support reply is read once.
Docs also decide how fast someone gets value from your product. A customer who can find the answer at 2am stays; one who waits until Monday often does not.
In practice
Support links a paragraph instead of writing one, and trials stop stalling quietly.
docs / basics / docs-and-ai
Why do docs matter for AI assistants?
AI assistants answer questions about your product by reading whatever is public. Your documentation is the source they quote. And when there is none, they improvise.
Structured pages make that reliable: clear headings, stable anchors, real examples and version metadata give an assistant something specific to cite instead of a guess.
In practice
A wrong AI answer about your product is still your support ticket.
docs / basics / structure
Is it not enough to just write more pages?
No. A long unstructured page hides the answer as effectively as having no page at all, search returns the document, not the paragraph the reader needed.
Structure is what makes docs usable: one question per heading, predictable navigation, tested steps, and metadata that says when the page was last true.
In practice
Having docs is not the goal. Being able to find the answer inside them is.
docs / basics / non-technical
We are not a technical company. Does this apply to us?
Yes. Documentation is just the written answer to anything a customer or a developer might ask, and that is not a technical idea.
We write for the reader you actually have. Plain-language guides for customers, precise references for developers, and nothing written to sound clever.
In practice
You will be asked to confirm facts, never to write the pages yourself.
docs / basics / working-together
How much of our team’s time does this take?
A kickoff call, a few short interviews, and review passes on drafts. We do the research, the structure and the writing; your team confirms the facts.
We write into the setup you already use, or set one up if you do not have one yet, and keep pages in step with your releases after launch.
In practice
Typical review load is a couple of hours per week during a project.
See it for yourself
Same product. Same facts. Only one of them answers.
Drag the handle. Nothing on the left is invented. It is what most documentation actually looks like a year in.
Take a 30-minute call and we will look at your product, your support queue and whatever docs exist today, or run the free Docs Score first and get the same read on your current pages in a couple of minutes.