logo
episode-header-image
Aug 21
23m 28s

Kate sounds off on cognitive capital and...

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 Manny Silva’s interview (S3:E14), Ryan Macklin’s interview (S3:E16), and Liz Argall’s interview (S3:E13) and the importance of learning even when we don’t have explicit reasons to do so.

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 15 articles since my last episode, taking my total to 565. 🎉This month’s velocity was a lot lower thanks to prepping for, teaching, and attending KnowledgeOwl’s July 2025 Summer Camp workshop series.

While teaching the classes was fun, it also triggered a lot of issues with my chronic illness, so I finished the month quite depleted on every level. This made me think a lot about the ambient and acute stress Ryan and I discussed in relation to empathy advocacy, and about how all documentation makes demands on readers’ cognitive capital. I share five documentation techniques that helped me get use from docs when I was struggling the most cognitively:

  1. Provide a summary, synopsis, TL;DR, or 1-2 context-setting sentences at the start of a doc or each section.
  2. Use strong page titles and headings, avoiding general catch-alls like “Frequently Asked Questions.”
  3. Format your content consistently using semantic elements like sequential headings.
  4. Use callouts, warnings, or admonitions sparingly but in consistent ways.
  5. Practice screenshot restraint.

I also reflect on how tricky it is to actually accommodate learning as a tech writer if I don’t have a pressing need for it. We learn new tools or domains often since it’s required. We learn new tooling or scripting to make our lives easier or because it’s required. We attend classes, conferences, or certifications. But we often don’t take time on less formal, bigger picture learning. I share how doing research to teach a class on style guides led me to find all kinds of flaws and oversights in my existing style guide. I challenge all of us to carve out 2-4 hours in the next month to dig deep on a best practice or concept we want to learn more about. If you lack the time or discipline and have a professional development budget, you can also consider joining me for the Information Architecture Master Class I’m teaching in partnership with KnowledgeOwl in September and October. Use discount code NOTBORING.


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 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 24
Kate sounds off on “good” documentation
🎓 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
25m 22s
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