The problem with single-sourced docs when fact checking with AI
To use AI for fact checking, AI tools might do better with a complete, self-contained set of documentation to check against a reference. Single-sourcing, with its conditional and fragmented content, complicates this model. Read more »
The allure of the loop (AI experiments)
In this experiment, I try to implement a loop of recursive self improvement on an essay, but it fails. Read more »
My first vibecoding project (AI experiments))
I'm starting a new series describing the various AI experiements I do. I've been looking for my next area of focus, and I realized that more than anything else, I like experimenting with new tools, techniqes, ideas, etc. So I'm writing a series of posts called AI experiments. Read more »
API quick reference guides (and the challenges of passing long content into AI contexts)
In my prompt engineering series, I added an article exploring how API quick reference guides (QRGs) can improve developer usability and also augment AI chat sessions with much-needed context. These QRGs are structured as hierarchical tree diagrams providing a visual map to complex APIs. The diagrams make it easier for developers to navigate and understand relationships between elements compared to traditional flat reference documentation. The article also includes a step-by-step process for creating these QRGs using AI. Read more »
Notes and discussion for Suleyman's The Coming Wave: AI, Power, and Our Future + AI Book Club recording and transcript
This post describes the key arguments and themes in The Coming Wave: AI, Power, and Our Future, by Mustafa Suleyman, for the AI Book Club: A Human in the Loop. This post not only breaks down the logic but also jumps off into some themes (beyond the book) that might be more tech-writer relevant, such as potential future job titles, areas of focus for tech writers to thrive now, questions for discussion, and more. It also contains the book club recording. Read more »
Reflections on the WTD Portland 2025 conference
This post captures some of my reflections on attending the 2025 Write the Docs conference in Portland. Some themes I discuss include the paradox of AI fatigue, the delight and difficulty of unconference sessions, why lightning talk formats are so challenging, and more. Read more »
AI-powered Enterprise Knowledge Platforms: Fluid Topics Q&A with Fabrice Lacroix
In this Q&A with Fabrice Lacroix, founder of Fluid Topics, I ask him questions about his recent tcworld article in which he argues for an innovative, advanced model for Enterprise Knowledge Platforms (EKPs) acting as a central AI-powered brain for all company content, delivered via APIs. Fabrice also outlines a future where tech writers become information architects, governing vast knowledge ecosystems and coaching diverse content contributors. Read more »
API quick reference diagrams and my upcoming AI the Docs presentation
In this post, I share my enthusiasm for API quick reference diagrams, which have significantly improved user comprehension and findability in our API documentation. I also explore how these diagrams serve as informative, low-token context for AI tools, enhancing their understanding of API structures (especially when accompanied with reference documentation) and how they counter hallucination in AI outputs. Finally, I end with a short tutorial on how to create these diagrams using AI. Read more »
|