Posts

Thoughts on technical writing, documentation strategy, docs-as-code, and the evolving role of writers.

May 2026

• What I've learned designing agentic workflows for docs
• Most vibe-coded tools are not for you

April 2026

• What makes docs beautiful?
• High fantasy map of tech writing (AI edition)

March 2026

• In the team of the future, roles are verbs, not nouns
• Skills are docs, and docs need tech writers

February 2026

• New habits for tech writers in the age of LLMs
• The writing was always the cheap part

January 2026

• The four modes of AI-augmented technical writing
• To those who fired or didn't hire tech writers because of AI

December 2025

• [Experiment] I interviewed Claude and Gemini about my 2025 blog posts
• My day as an augmented technical writer in 2030

November 2025

• Code wikis are documentation theater as a service
• You need an AI policy for your docs

October 2025

• Why I built an MCP server to check my docs (and what it taught me)

September 2025

• When docs become performance art, everybody loses
• The future is open: Answering the most common tech writing worries

August 2025

• Contributing a verse: When users become documentation authors
• AI must RTFM: Why technical writers are becoming context curators

July 2025

• How I write docs quickly

June 2025

• Things technical writers shouldn't care about... yet
• Conjuring digital companions: How I'm thinking better through AI
• On finding time to write (this is not productivity advice)

May 2025

• How to grow as a technical writer

April 2025

• Own the prompt: Build your own tech writing tools using LLMs
• Update to my tech writing gear and tools
• What's wrong with AI-generated docs

March 2025

• Technical writing has a depth issue
• Technical English is nobody's mother tongue

February 2025

• My time machine runs on technical writing

January 2025

• Should you write documentation differently for LLMs?
• The Seven-Action Documentation model

December 2024

• My technical writing predictions for 2025
• The best docs are the ones we don’t remember

November 2024

• FAQs are not the answer
• Why I became a Documentation Engineer (and what that even means)

October 2024

• How I'm using AI as a technical writer
• What docs as code really means

September 2024

• TypeSpec reminds us why OpenAPI exists in the first place

August 2024

• Failing (and surviving failure) as a technical writer

July 2024

• How to set up your tech writer up for success

June 2024

• Contributing to open source docs as a technical writer
• Review of Technical Writing for Software Developers

May 2024

• Technical writing is not a dead-end job, it's a landing pad
• Things I remind myself when working with others

April 2024

• My favorite books for tech writers

March 2024

• The pros and cons of using Markdown
• Technical writing in 2049

February 2024

• What to do when you're feeling AI anxiety as a tech writer

January 2024

• Signs that you need a technical writer
• Docs observability, or measuring docs inside a product-docs system

December 2023

• What tech writers can learn from video game manuals

November 2023

• Tips for hiring your first technical writer

October 2023

• My favorite tech writing tools

September 2023

• Bestiary: On Doc Types and Other Animals
• Tips for job hunting as a technical writer

July 2023

• An experiment in humorous documentation

June 2023

• A tech writer's letter to software developers
• How did I become a technical writer

May 2023

• Docs-as-code topologies

March 2023

• We need more technical writing in popular culture
• High fantasy map of technical writing

January 2023

• My technical writing gear (how I work)
• Hiring technical writers in a ChatGPT world

December 2022

• The rise of WriterBot

November 2022

• How to become a technical writer

October 2022

• Learning to code as a technical writer
• My first children’s book is about... OpenTelemetry

September 2022

• Circles of Product Truth

August 2022

• Docs Hierarchy of Priorities: A Proposal
• Tech Writing Skills Tree
• Measure it till you make it

July 2022

• A love letter to technical writing
• Let's blog more about technical writing
• How to introduce prose linters at your workplace

June 2022

• Do it yourself: User research for technical documentation

May 2022

• Markdoc is not what you expected, and that's a good thing
• Technical writing syllabus

January 2022

• Why I collect and read old computer manuals

December 2021

• An update to my tips for working remotely

November 2021

• Better docs, less pain: the case for new docs-as-code standards

October 2021

• The Columbo Technique for Technical Writers

August 2021

• OpenAI and docs: AI-aided technical writing is here to stay

May 2021

• First steps with the Vale prose linter

March 2021

• Levels of embedded documentation

February 2020

• Working with remote teams: My Tips

October 2019

• What is technical writing?