Blog

Insights on technical writing, documentation, and communication.

Posts from 2026 35 posts View all posts

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.

What to Look for When Hiring a Technical Writer

Clinton De Young Hiring

Hiring a technical writer is harder than it looks, and the cost of getting it wrong shows up in support queues, developer frustration, and user trust long before anyone connects it to the documentation. Here's what to look for, and what to avoid.