Resources

Communities and People Worth Following

• Write the Docs ↗

  The global community for people who care about documentation.

• I'd Rather Be Writing — Tom Johnson ↗

  Long-running blog on API documentation, AI, and the craft of technical writing.

• AI Book Club: A Human in the Loop ↗

  Tom Johnson's monthly book club on AI and its impact on technical writing and society.

• Dachary Carey ↗

  Writing on developer docs, docs-as-code, and documentation engineering.

Style Guides for Technical Writers

If you're just getting started in technical communication, I recommend becoming familiar with at least one tech writing style guide. Here are a few great ones.

• Apple Style Guide ↗

  This is my go-to style guide when creating technical content. Like most of Apple's products, the content is intentionally designed to be simple and easy to understand.

• Google Developer Documentation Style Guide ↗

  If you're primarily creating content for software developers, I recommend this style guide. It provides guidance on how to document command-line interfaces, API calls, and code blocks. It also addresses how and when to apply inline code formatting.

• Microsoft Writing Style Guide ↗

  This is the most comprehensive style guide for technical writers. This was my go-to resource when I first started in tech comm because the printed copy was easy to navigate.

Books on Writing

Required reading for any professional writers, not just technical communicators. These books shaped both the content I create and my approach to writing in general.

• The Elements of Style ↗

  by William Strunk and E. B. White

  Short and concise, just like the writing style the authors recommend.

• Eats, Shoots & Leaves: The Zero Tolerance Approach to Punctuation ↗

  by Lynne Truss

  This is like the cheeky British descendant of "The Elements of Style." If dry wit helps you remember rules better, this book is for you.

• On Writing: A Memoir of the Craft ↗

  by Stephen King

  Part memoir, part manual, this book has practical advice for how to write prose that connects with people.

Tools I Use

• Mintlify ↗

  Docs-as-code platform. Led a full migration onto it and maintain a production docs site with it.

• Claude & Claude Code ↗

  Drafting, review, and agentic documentation workflows, guided by a CLAUDE.md that encodes the style guide.

• Cursor ↗

  Day-to-day editor for docs-as-code and sample code.

• Astro ↗

  What this site is built with.