Marketing automation SaaS. 42 employees. Series A closed. They hired an agency to redesign their website — recommended, SaaS portfolio, $18,000 for a six-week engagement.
Three designers. One copywriter. Two rounds of revisions. Very professional process.
The agency delivered a stunning homepage. Smooth animations. Sharp copy. Customer logos. Case study page. Pricing with a toggle. Everything you’d expect from a marketing site that forgot it was selling software.
Launch week. Traffic came in. Conversions stayed flat.
Week two numbers: 8,200 homepage visitors. Technical buyers — CTOs, engineers, security evaluators — made up 35% of that traffic, roughly 2,840 people. Their bounce rate: 71%. Trial signups: 2.1%. Average session for technical visitors: 1 minute 47 seconds.
The founder called. “Our new website looks professional but engineers aren’t signing up. What’s wrong?”
I clicked around the way a technical buyer would. Homepage — clicked “Documentation” in the footer — 404 error. Clicked “API” — redirected to a generic contact sales form. Looked for a changelog — didn’t exist. Found the security page: one paragraph that could have applied to a bakery.
“Your website’s beautiful,” I said. “But you’re lying to technical buyers.”
Not intentionally. But when your SaaS documentation is hidden, thin, or broken, that’s what it looks like to someone evaluating your product seriously. The agency built a marketing site. Technical buyers wanted product truth. The gap between those two things was a 71% bounce rate.
What Technical Buyers Actually Do
High-intent technical visitors don’t read hero sections. They skim the homepage for 20 seconds and then go looking for the things that tell them whether the product is real.
They want to know three things. First: what it actually does. Not “AI-powered workflow automation” — endpoints, limits, examples, the specific capabilities that confirm the homepage claims are true. Second: where it breaks. Rate limits, timeouts, data residency, unsupported edge cases. Honest constraints convert better than vague promises because they signal a company that knows its product well enough to be specific about it. Third: how long implementation takes. If a new user can’t get to a working first run in under five minutes from your quick start guide, most of them won’t.
If your homepage is the pitch, your SaaS documentation is the proof. Every technical buyer knows this. The ones you’re losing to bounce are the ones who went looking for proof and found nothing.
What Actually Fixed It
Four weeks. $6,800 budget. Here’s what changed:
Week 1 — Documentation foundation. Built a proper docs site — not hidden in the footer, in the main navigation. Wrote five quick start guides, each copy-paste and runnable in under five minutes. API reference with real endpoints, not “contact us for access.” Added a limits and quotas page covering rate limits, timeouts, and data residency. Rewrote the security page to answer the 80% of security questionnaire questions that come up on every enterprise deal.
Week 2 — Changelog. Published a public changelog — not behind a login. Documented the previous six months of updates in a consistent format: date, category (feature, fix, performance), description, link to relevant docs. Added a “Recent Updates” strip to the homepage showing the three latest entries. Small thing. Significant signal.
Week 3 — Proof blocks on the homepage. Added a working code snippet — curl and JavaScript, both runnable. A live status badge linking to uptime history. A metrics card showing median API latency. A “Works with” list reflecting actual integrations. These replaced three paragraphs of adjectives that nobody believed anyway.
Week 4 — Findability. Made the docs fast on mobile and properly searchable. Fixed every broken internal link. Added a sticky nav to the docs site so users doing real work weren’t hunting for their place.
The Numbers After
Before: technical buyer bounce rate 71%, trial signups 2.1%, average technical session 1 minute 47 seconds, doc page views 140 per week (mostly 404s), demo requests from engineers 3 per week.
After: technical buyer bounce rate 39%, trial signups 3.6%, average technical session 6 minutes 22 seconds, doc page views 2,180 per week, demo requests from engineers 14 per week.
Trial signups increased 71%. Sales cycle shortened by 11 days because engineers arrived at demos having already read the docs — sales conversations started with “I have a question about your rate limits” instead of “explain what this does.” Support tickets about basic functionality dropped 43%. 62% of new trials had touched the SaaS documentation before signing up.
They spent $18,000 on a homepage that didn’t convert technical buyers. They spent $6,800 on documentation that did.
What Good SaaS Documentation Actually Requires
Quick starts that actually run. One page per common job-to-be-done. Copy-paste code that works in five minutes without reading anything else first. No “contact your account rep for an access token.” No ceremony. If it doesn’t run, don’t publish it. Test every quick start yourself before it goes live — if you can’t get it working in five minutes without reading adjacent docs, rewrite it. Most teams skip this step. That’s why most SaaS onboarding fails before users reach the product.
Real reference documentation. Full spec, searchable, organised by what users need to do rather than by your internal architecture. Engineers want Ctrl+F to work. Don’t hide it, don’t bloat it, don’t make it require a login to access.
Honest limits. Rate limits, quotas, timeouts, data residency — all public, all specific. If you can’t show the numbers, the problem isn’t the documentation. “Highly scalable” with no numbers is how you lose engineers to competitors who publish actual limits.
A security page that answers questions. One page, not a PDF. Covers data residency, retention policy, permissions model, audit logging, SOC 2 or ISO status, breach process. A PDF security document signals it was copied from an enterprise sales deck and hasn’t been updated since. A live page signals ownership.
A public changelog. Weekly or fortnightly entries in a consistent format. Terse, tagged by category, linked to relevant docs. Three things to avoid: novel-length posts, vanity updates about brand colour changes, and “coming soon” items that teach prospects the changelog can’t be trusted. The marketing automation company had no changelog. When asked why: “We ship constantly, too much to document.” Translation: no one was tracking what shipped. After six months of honest changelog entries went live, demo requests increased — because buyers could see the product was actively maintained.
Where Most SaaS Websites Get This Wrong
Glossy site, thin docs. Looks like a brochure, behaves like a trap. Engineers arrive expecting substance and find adjectives.
Documentation buried in the footer. If the docs link is small, grey, and below the fold, you’re signalling the product can’t bear scrutiny. The marketing automation company had “Documentation” in the footer in small text. After it moved to the main navigation, doc traffic increased 1,900% — not because more people wanted docs, because more people could find them. Hidden navigation is UX debt pretending to be minimalism.
API access behind a contact form. Evaluating five tools simultaneously is normal for technical buyers. Hiding critical functionality behind a sales call is how you become tool number five. Competitors with public docs and a working quick start get evaluated first.
Security page as a PDF download. If it requires a download, it’s already out of date. Answering the same security questionnaire in a live page takes one afternoon and saves every subsequent enterprise deal from a two-week back-and-forth.
“Docs coming soon.” Every week that message sits there, technical buyers are making the same decision. The competitor who has docs now wins that evaluation.
The Ownership Problem
The marketing automation company had nobody owning documentation. Product assumed marketing would handle it. Marketing assumed product would handle it. Engineering assumed someone else was handling it. Nobody handled it — and the 404 on the documentation link was the most visible symptom of a much deeper problem.
Good SaaS documentation doesn’t require a dedicated technical writer. It requires one person with ownership, a consistent format, and a small weekly time budget. After the company assigned a senior PM to own docs with four hours per week allocated, the docs stayed current. Not perfect — current. That’s all technical buyers need.
The maintenance rhythm that works: monthly tidy pass to fix broken links and update changed behaviour, quarterly consolidation to kill pages that have become redundant, and a 48-hour review loop between product, engineering, and whoever owns docs for anything that ships.
Track one metric most teams ignore: doc-assisted conversions. Sessions that touched SaaS documentation before signup or demo request. For the marketing automation company it was 62% of new trials. If you’re not measuring it, you don’t know whether your documentation is actually selling or just existing.
The Quick Check
Eight questions. If you can’t answer yes to six of them, the next website project is a docs project.
Is “Docs” in the main navigation and does it load fast on mobile? Is there a quick start guide that runs in under five minutes without any other help? Are rate limits, quotas, timeouts, and data residency published publicly? Does a security page exist as a live page — not a PDF — that answers 80% of standard security questions? Does the changelog have entries from this month with links? Does the homepage have one working code snippet and a real status badge? Are doc-assisted conversions being tracked? Does one person own documentation with a defined cadence?
Homepage design without documentation strategy is decoration. It looks credible from the outside and fails the moment a technical buyer looks underneath.
Fix the truth first. The homepage can wait.