logo
episode-header-image
Jul 24
25m 22s

Kate sounds off on “good” documentation

Kate Mueller
About this episode

🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!

🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!

🔗 Read more info and sign up: thenotboringtechwriter.com/learning


In this solo episode, Kate shares an update on her content update progress. She also reflects on Nick Graziade’s interview (S3:E12) and Liz Argall’s interview (S3:E13) and the ways these interviews highlight some elements of “good” docs experiences.

I’ve continued my work to update the KnowledgeOwl Support Knowledge Base to align with major navigation and UI changes that were rolled out in December. I updated an additional 43 articles since my last episode, taking my total to 550. 🎉 I’m in the middle of updating our Contextual Help Widget documentation—one of the features I’ve been putting off updating—and I’ve been drafting content for our forthcoming AI Chatbot feature, too.

Nick and I share a tech writer villain origin story of absolutely adoring LEGO documentation, and it’s gotten me curious how many other tech writers also have this early exposure to documentation. And for some reason I’m seeing tech writing everywhere. I share a detailed story of Bont Cycling’s online shoe fit guidance, which I recently used and which has created a fairly positive product experience for me. Good documentation experiences can help create good product experiences.

I also reflect on Liz’s comment that “The best fertilizer is the gardener’s shadow.” She talked about this in the context of just showing up to work on docs, but I extend that metaphor to say showing up working with care. I gave two examples of this. I’ve been struggling with some personal losses, so a lot of my docs work lately has been a blitz of low-hanging docs fruit: a lot of small changes and improvements. None of these updates are substantive, but they’re good iterative improvements and they helped me get back into docs work. I also share a story of building a long-procrastinated-on bench for my entryway, which was more about accepting good rather than great just to get something built. Good docs are dynamic and iterative–they may not be perfect at first, but they’re constantly improving and always striving for a better reader experience.

Resources discussed in this episode:


Join the discussion by replying on Bluesky



Contact The Not-Boring Tech Writer team:

We love hearing your ideas for episode topics, guests, or general feedback:


Contact Kate Mueller:


Contact KnowledgeOwl:


Up next
Aug 21
Kate sounds off on cognitive capital and learning
🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!🔗 Read more info and sign up: thenotboringtechwriter.com/l ... Show More
23m 28s
Aug 7
Empathy advocacy: Designing docs for all emotional states with Ryan Macklin
🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!🔗 Read more info and sign up: thenotboringtechwriter.com/l ... Show More
52m 35s
Jul 10
Docs as Tests: Keeping documentation resilient to product changes with Manny Silva
🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!🔗 Read more info and sign up: thenotboringtechwriter.com/l ... Show More
1h 5m
Recommended Episodes
Jul 2024
Tracking technology stacks, practices and experiences across teams
Understanding your technology estate and how it's being leveraged is critical for organizations; it impacts everything from financial planning to capability development. But given the rapid pace of change — even inside a single organization, let alone the wider industry — how can ... Show More
36m 59s
Dec 2024
124. From Ideas to Impact: Chris Strahl and Evan Lovely on Five Years of Design Systems Innovation
Send us feedback or episode suggestions.In this special episode of the Design Systems Podcast, co-founders Chris Strahl and Evan Lovely celebrate five years of the podcast and reflect on their journey from agency work to building Knapsack. They discuss the evolution of design sys ... Show More
34m 2s
Apr 2025
Agentic AI for IT Pros with Tim Warner
What can agentic AI do for you? Richard talks to Tim Warner about his work utilizing next generation agentic AI technologies to help with sysadmin tasks. Tim talks about the early lead that Cursor AI took with AI agents capable of writing and executing scripts on your behalf - as ... Show More
34m 44s
May 2024
GSK’s Use of AI in Vaccine Tech, Drug Discovery
GSK’s Chief Digital and Technology Officer Shobie Ramakrishnan discusses how the company is leveraging AI and data models for vaccine development and drug discovery in this episode of Bloomberg Intelligence’s Tech Disruptors podcast. BI’s Health-Care Analyst Sam Fazeli and Techno ... Show More
42m 42s
Feb 2025
Tool calling and agents
It seems like everyone is uses the term “agent” differently these days. In this episode, Chris and Daniel dig into the details of tool calling and its connection to agents. They help clarify how LLMs can “talk to” and “interact with” other systems like databases, APIs, web apps, ... Show More
45 m
Aug 2024
GemFire with Ivan Novick
Tanzu GemFire is a distributed, in-memory, key-value store that performs read and write operations at fast speeds. It offers highly available parallel message queues, continuous availability, and a scalable event-driven architecture. It was developed to have sub-millisecond respo ... Show More
34m 12s
Oct 2022
AI Today Podcast: Applying CPMAI in the Real World, Interview with Andrew Stone, Maximus
It’s one thing for us to talk about the Cognitive Project Management for AI (CPMAI) Methodology and the benefits it can bring to managers running AI and advanced data projects, but hearing directly how individuals are applying the CPMAI Methodology can be incredibly valuable. In ... Show More
47m 26s
Nov 2024
476. Navigating the Murky Waters of Data Rights with Brad Templeton
From medicine to technology, our world is run by science. In this episode of the Marketing Speak podcast, join our dive into technology and its impact as we sit down with Brad Templeton to unravel the intricacies of our tech-driven world. Brad is the founding faculty for Computin ... Show More
34m 57s