For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

Search results

2025 archives

  1. Achieving a feedback improvement loop with documentation by simulating user queries

  2. Q&A about Nytril, a programming language for building documents, with Shawn McCreight

  3. Chunking your content for agent readability

  4. Looking at a site like an agent — identifying semantics in styling

  5. Making documentation pages agent friendly

  6. My AI strategy to fix docs based on chat logs

  7. AI Book Club recording of Project Maven: A Marine Colonel, His Team, and the Dawn of AI Warfare, by Katrina Manson

  8. Why docs still need an owner — podcast with CT Smith about WTFM

  9. How I turn my API doc course into a PDF and sell it on Buy Me a Coffee

  10. Building machines that work with other machines

  11. Building out my agent skills course and rethinking product skills

  12. AI Book Club recording: I Am Not a Robot by Joanna Stern

  13. Six new books in tech comm: a roundup

  14. Buying a car in the age of AI

  15. Why biking to work fails when commuting from Renton to Seattle

  16. Writing for an audience of agents — podcast with Ethan Palm from Mintlify

  17. Review of The MANIAC, by Benjamin Labatut -- thoughts on logic and the end of play

  18. AI Book Club recording of The MANIAC by Benjamin Labatut

  19. Reflections on Ai4 conference - some absences from a tech writer's POV

  20. Orchestrating docs instead of writing them yourself — podcast with Sarah Deaton of Anthropic

  21. Building out a course on agent skills

  22. The gap between academic and industry technical writing: What it is, why it exists, why it's important, and what we can do about it (Part II)

  23. The gap between academic and industry technical writing: What it is, why it exists, why it's important, and what we can do about it (Part I)

  24. Tom's opinionated guide to skill building 101

  25. AI Book Club discussion of The Infinity Machine by Sebastian Mallaby

  26. Judging beautiful docs, AI fatigue, and tool slop -- podcast with Fabrizio

  27. Review of Max Tegmark's 'Life 3.0: Being Human in the Age of Artificial Intelligence'

  28. AI Book Club discussion recording of 'Life 3.0: Being Human in the Age of Artificial Intelligence', by Max Tegmark

  29. Developing internal skills for recurring documentation processes like release notes

  30. Looking back at the AI Book Club one year in

  31. On pace and value -- why is moving slow boring?

  32. Frenetic thinking

  33. Work expands to fill the space allotted

  34. Too much coffee?

  35. AI Book Club discussion recording of 'Breakneck: China's Quest to Engineer the Future', by Dan Wang

  36. Some thoughts after using AI to help with taxes

  37. Podcast: How valuable are agent skills? Conversation with Larah Vasquez and Fabrizio Ferri-Benedetti

  38. The Emerging Picture of a Changed Profession: Cyborg Technical Writers — Augmented, Not Replaced, by AI

  39. Will tech writers survive AI? Perspectives from two professors, Nupoor Ranade and Jeremy Merritt

  40. AI Book Club recording of 'If Anyone Builds It, Everyone Dies'

  41. Recording of Automation Engineering 101 for Tech Docs presentation at WTD West Coast Supermeetup

  42. Cracking the code on corporate visibility

  43. Podcast: Doc testing, skills files, and the guardians of knowledge -- with Manny Silva

  44. Nobody knows what it will look like in 2 years

  45. Good shot, GUS!!!! How to win at pickup basketball even if you're not all that great

  46. 10 principles of the cyborg technical writer -- brief notes and bullet points on how to use AI to augment your role

  47. World Brain: No Experts podcast - Three tech writers and a photographer walk into a bar (with Tom Johnson and Floyd Jones)

  48. Using curiosity to decenter

  49. AI Book Club recording, notes, and transcript for Sarah Wynn-Williams's Careless People

  50. Bakhtin and model collapse: How to use AI with expressive writing without generating AI slop

  51. Podcast: Tech comm predictions for 2026 (Phase One)

  52. AI Book Club recording of God, Human, Animal, Machine

  53. Podcast: Writing as telepathy: AI tools, automation, and an intentionally offline life -- conversation with CT Smith

  54. Book review of 'If Anyone Builds It, Everyone Dies'—why AI doom isn't as visceral as nuclear war

  55. 12 predictions for tech comm in 2026

Sponsored

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.