The Docs Are The Front Door
- A developer tools company, post-Series-A, selling an API to engineering teams.
- No logo wall. No stock illustration. No claim that can’t be verified in under sixty seconds by the reader.
Devtool marketing sites are written for the person who signs. They’re read by the person who decides. Those are different people, and the site optimizes for the wrong one.
An engineer evaluating an API does one thing: tries it. Every section standing between the landing page and the first working request is a tax on that. Most devtool sites charge that tax three or four times — hero, social proof, feature grid, testimonial carousel — before revealing an install command.
The result is a site that reads well to a VP and gets skimmed by the only person whose opinion converts.
Invert the hierarchy. The quickstart is the homepage. Marketing copy earns its place only where it survives sitting directly next to working code.
Everything argued has to justify itself against something executable on the same screen.
Standard hero + logo wall + feature grid. Rejected because a logo wall is an unverifiable claim, and this audience discounts unverifiable claims by default. Worse: it’s the exact layout every competitor ships, so it differentiates nothing while costing above-the-fold space.
Interactive playground / embedded sandbox. Genuinely good, and rejected on cost. It’s weeks of build time to reduce time-to-first-success by less than showing a copy-pasteable curl command does in one afternoon. Right idea, wrong sequencing — this is a phase-two decision, not a launch decision.
Video demo above the fold. Rejected. It asks for ninety seconds of attention before delivering anything, from a reader who’ll give thirty.
Voice: Imperative mood, second person. No adjective that can’t be measured. “Fast” is banned; p99 under 40ms is not.
Type as a contract: Anything set in IBM Plex Mono is executable — copy it, paste it, it runs. Anything set in General Sans is argued, not proven. That rule has teeth. It means the type system tells the reader what they’re allowed to trust before they’ve read a word. Break the rule once and the whole system is a lie.
Structure: Quickstart → what it costs → what it doesn’t do → who it’s for. The “doesn’t do” section is deliberate. Stating limits early is the cheapest credibility available, and it filters out the wrong evaluator before they file a support ticket.
- Static generation. Docs authored in MDX so documentation and marketing share one content pipeline — no drift between what the docs say and what the site claims.
- Performance budget: LCP under 1.2s on simulated 4G. Zero JavaScript required for first paint of the quickstart block. If the code sample needs a framework to appear, the site is arguing against itself.
- Client-side search index capped at 50kb. Search that works instantly matters more here than search that’s clever.
- Syntax highlighting at build time, not runtime.
Primary: time from landing to first successful API call. Not signups. Signups are a vanity number in devtools; activation is the real one.
Secondary: quickstart copy-button click rate. It’s the cleanest available proxy for genuine intent.
Signups rise and activation doesn’t. That would mean the site is still attracting evaluators rather than builders, and the inversion failed at exactly the point it was designed to fix.
This risks under-serving the enterprise buyer who needs procurement material. Mitigation: one clearly-marked route for teams — not a parallel site. Two sites means two voices, and two voices means neither is trusted.