Posts

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

October 2026

1. Rethinking the tech writing portfolio in the AI ageOct 29
2. Living House: Adaptive UI and docs using in-browser inferenceOct 23

September 2026

1. Tech needs humanists more than everSep 7

August 2026

1. Does whispering to agents in docs help?Aug 17

July 2026

1. Advice for tech writers on a job hunt in the AI ageJul 29
2. You can write in LLMese, but you don’t have toJul 12

June 2026

1. Feed the machines, then guide the humansJun 12
2. Fine-tuning an LLM to write docs like it's 1995Jun 1

May 2026

1. What I've learned designing agentic workflows for docsMay 11
2. Most vibe-coded tools are not for youMay 6

April 2026

1. What makes docs beautiful?Apr 20
2. High fantasy map of tech writing (AI edition)Apr 11

March 2026

1. In the team of the future, roles are verbs, not nounsMar 22
2. Skills are docs, and docs need tech writersMar 8

February 2026

1. New habits for tech writers in the age of LLMsFeb 28
2. The writing was always the cheap partFeb 24

January 2026

1. The four modes of AI-augmented technical writingJan 25
2. To those who fired or didn't hire tech writers because of AIJan 12

December 2025

1. My day as an augmented technical writer in 2030Dec 13

November 2025

1. Code wikis are documentation theater as a serviceNov 15
2. You need an AI policy for your docsNov 10

October 2025

1. Why I built an MCP server to check my docs (and what it taught me)Oct 13

September 2025

1. When docs become performance art, everybody losesSep 24
2. The future is open: Answering the most common tech writing worriesSep 14

August 2025

1. Contributing a verse: When users become documentation authorsAug 31
2. AI must RTFM: Why technical writers are becoming context curatorsAug 8

July 2025

1. How I write docs quicklyJul 21

June 2025

1. Things technical writers shouldn't care about... yetJun 23
2. Conjuring digital companions: How I'm thinking better through AIJun 18
3. On finding time to write (this is not productivity advice)Jun 7

May 2025

1. How to grow as a technical writerMay 18

April 2025

1. Own the prompt: Build your own tech writing tools using LLMsApr 26
2. Update to my tech writing gear and toolsApr 14
3. What's wrong with AI-generated docsApr 1

March 2025

1. Technical writing has a depth issueMar 13
2. Technical English is nobody's mother tongueMar 1

February 2025

1. My time machine runs on technical writingFeb 10

January 2025

1. Should you write documentation differently for LLMs?Jan 24
2. The Seven-Action Documentation modelJan 9

December 2024

1. My technical writing predictions for 2025Dec 27
2. The best docs are the ones we don’t rememberDec 15

November 2024

1. FAQs are not the answerNov 30
2. Why I became a Documentation Engineer (and what that even means)Nov 24

October 2024

1. How I'm using AI as a technical writerOct 30
2. What docs as code really meansOct 20

September 2024

1. TypeSpec reminds us why OpenAPI exists in the first placeSep 2

August 2024

1. Failing (and surviving failure) as a technical writerAug 18

July 2024

1. How to set up your tech writer up for successJul 6

June 2024

1. Contributing to open source docs as a technical writerJun 24
2. Review of Technical Writing for Software DevelopersJun 9

May 2024

1. Technical writing is not a dead-end job, it's a landing padMay 29
2. Things I remind myself when working with othersMay 12

April 2024

1. My favorite books for tech writersApr 25

March 2024

1. The pros and cons of using MarkdownMar 27
2. Technical writing in 2049Mar 17

February 2024

1. What to do when you're feeling AI anxiety as a tech writerFeb 10

January 2024

1. Signs that you need a technical writerJan 17
2. Docs observability, or measuring docs inside a product-docs systemJan 8

December 2023

1. What tech writers can learn from video game manualsDec 13

November 2023

1. Tips for hiring your first technical writerNov 8

October 2023

1. My favorite tech writing toolsOct 22

September 2023

1. Bestiary: On Doc Types and Other AnimalsSep 23
2. Tips for job hunting as a technical writerSep 16

July 2023

1. An experiment in humorous documentationJul 17

June 2023

1. A tech writer's letter to software developersJun 25
2. How did I become a technical writerJun 18

May 2023

1. Docs-as-code topologiesMay 14

March 2023

1. We need more technical writing in popular cultureMar 30
2. High fantasy map of technical writingMar 12

January 2023

1. My technical writing gear (how I work)Jan 29
2. Hiring technical writers in a ChatGPT worldJan 4

December 2022

1. The rise of WriterBotDec 3

November 2022

1. How to become a technical writerNov 7

October 2022

1. Learning to code as a technical writerOct 30
2. My first children’s book is about... OpenTelemetryOct 14

September 2022

1. Circles of Product TruthSep 19

August 2022

1. Docs Hierarchy of Priorities: A ProposalAug 28
2. Tech Writing Skills TreeAug 11
3. Measure it till you make itAug 6

July 2022

1. A love letter to technical writingJul 18
2. Let's blog more about technical writingJul 15
3. How to introduce prose linters at your workplaceJul 3

June 2022

1. Do it yourself: User research for technical documentationJun 24

May 2022

1. Markdoc is not what you expected, and that's a good thingMay 11
2. Technical writing syllabusMay 2

January 2022

1. Why I collect and read old computer manualsJan 22

December 2021

1. An update to my tips for working remotelyDec 20

November 2021

1. Better docs, less pain: the case for new docs-as-code standardsNov 1

October 2021

1. The Columbo Technique for Technical WritersOct 21

August 2021

1. OpenAI and docs: AI-aided technical writing is here to stayAug 27

May 2021

1. First steps with the Vale prose linterMay 20

March 2021

1. Levels of embedded documentationMar 3

February 2020

1. Working with remote teams: My TipsFeb 4

October 2019

1. What is technical writing?Oct 9