Field manuals
Launching an API or MCP Server: Day-One Needs
A checklist for launching a public API or an MCP server: reference docs, authentication, limits, errors, examples, versioning and a way to get help.
- Developer tools
- 10 min read
Privacy and Data-Use Statements for AI Tools
What users need to know about how an AI tool handles their data: inputs, storage, training, sub-processors and deletion, written in plain words.
- AI
- 10 min read
Developer Experience in the First Five Minutes
Time to first success is the launch metric for developer tools. How to measure it, remove friction from install, auth and first call, and keep docs honest.
- Developer tools
- 10 min read
Launching an AI Product Without the Hype
How to describe an AI product accurately at launch: what it does, where it fails, how you tested it and which claims to avoid. A plain-language checklist.
- AI
- 10 min read
Changelogs and Roadmaps for Tools That Change Weekly
When a tool ships weekly, users need a changelog and roadmap that keep up: cadence, breaking-change labels and promising only what you can keep.
- Developer tools
- 10 min read
Explaining Model Choices and Limits to Your Users
Which model you use, why, what it can and cannot do and how it may change: a practical guide to telling users enough about the AI inside your product.
- AI
- 10 min read
Explaining What Is New in Frontier Tech
How to write about new technology for people who have not met it: start from the problem, define terms once, show an example and mark what is unproven.
- Writing
- 10 min read
A Dev Tool Launch: Treat the README as the Landing Page
For developer tools, the README is often the first and most trusted page. What to put in it, in what order, and how it should match your site and listing.
- Developer tools
- 10 min read
Benchmarks and Evals You Can Defend in Public
Performance claims for AI and developer tools survive scrutiny when the test is described, repeatable and honest. How to design and report evaluations.
- AI
- 10 min read
Open-Source Launches and Your First Contributors
Launching an open-source project is not only releasing code. Licences, onboarding, issue triage, a code of conduct and how to welcome first contributors.
- Open source
- 10 min read