Blog

Insights on technical writing, documentation, and communication.

Posts from May 2026 2 posts View all posts

Documentation Has a Voice, and Yours Probably Doesn't

Clinton De Young Finding Your Voice

Most B2B documentation isn't voiceless. It's written in "corporate beige," the hedged, committee-approved prose that signals no one cared enough to commit to a claim. Voice is the cumulative effect of small, purposeful decisions that help your documentation read as if someone knowledgeable wrote it to help me solve a problem. Do you want to improve your documentation? Pick a voice and defend it.

Your API Reference Is Not Your API Documentation

Clinton De Young API Documentation

OpenAPI is an excellent reference, but a rendered spec is not documentation. A reference catalogs what endpoints exist; documentation teaches developers how to accomplish their goals. This post lays out five reasons reference-only docs fail your customers and what to write alongside your OpenAPI spec to fix it.