I recently added quick reference pages to our API docs.
Badges
Badges come from GitHub once the author claims this feed.
Recent posts
every link opens the author’s post-
Rediscovering the quick reference for a new audience: agents
-
A three-phase path to reinventing the tech comm career
As agent skills, tools, and frontier models have matured this year, I've been able to compress five days of routine documentation work into one.
-
AI Book Club recording of Co-Existence by Ethan Mollick
This is a recording of our AI Book Club discussion of Co-Existence: The Next Phase of AI by Ethan Mollick, held November 15, 2026.
-
Agent readability: Carrying over top-level page notes into independent chunks
Of all my articles on agent readability, none has attracted as much attention as Chunking your content for agent readability, probably because chunking raises so many hard problems for tech comm.
-
Documentation at Scale with Andrew Etter: Ten years after Modern Technical Writing
In this podcast, I chat with Andrew Etter about his new book, Documentation at Scale: Best-in-class content for the AI era, the follow-up to his 2016 book Modern Technical Writing.
-
Updates to my coffee, car-buying, and zero-drop shoe posts, plus my Jekyll documentation theme
I don't often update previous posts, but I recently updated four things I really wanted to revisit.
-
Achieving a feedback improvement loop with documentation by simulating user queries
A couple of weeks ago, I wrote about a documentation strategy I'm pursuing: mining chat logs from AI app builders to find doc problems and fix them in a continuous loop.
-
Chunking your content for agent readability
This post continues my series on agent readability by looking at chunking.
-
Q&A about Nytril, a programming language for building documents, with Shawn McCreight
Nytril is a document authoring tool built on its own programming language, where text, data, calculations, and formatting all live in source code that runs to produce documents.
-
Looking at a site like an agent — identifying semantics in styling
Following up on my previous post about content that loads through JavaScript, this post looks at another agent-readability problem: styling that carries meaning.
-
Agent readability: Why agents can't see content that JavaScript loads on click
This week I'm working on making our doc site agent friendly.
-
My AI strategy to fix docs based on chat logs
My strategy for improving docs has two stages.
-
AI Book Club recording of Project Maven: A Marine Colonel, His Team, and the Dawn of AI Warfare, by Katrina Manson
This is a recording of our AI Book Club discussion of Project Maven: A Marine Colonel, His Team, and the Dawn of AI Warfare by Katrina Manson, held October 18, 2026.
-
Why docs still need an owner — podcast with CT Smith about WTFM
In this podcast, co-host Fabrizio Ferri-Benedetti and I chat with CT Smith about her new book, WTFM: A Practical Guide for Standing Up Docs at a Startup.
-
How I turn my API doc course into a PDF and sell it on Buy Me a Coffee
My API documentation course is free on the web, but I also sell a PDF version of it through Buy Me a Coffee.