Articles
Welcome—glad you stopped by. The Articles page is where I share practical advice, real-world stories, and insights on technical writing, documentation, and information design. Whether you’re just starting out or looking to sharpen your skills, there’s something there for you.
Final Check: Testing Documentation for Clarity and Success
You’ve written the document. It’s structured, formatted, and reviewed. But is...
When Writing Fails: Common Pitfalls That Hurt Usability
Technical writing isn’t about sounding smart—it’s about making things work....
The Flow of Documentation: Organizing for the User’s Mind
Have you ever opened a document and immediately felt lost? The information is...
Chunking, Lists, and Headings: Why They Work
Ever tried reading a wall of text and felt your brain shut down? That’s what...
Final Check: Testing Documentation for Clarity and Success
You’ve written the document. It’s structured, formatted, and reviewed. But is it actually clear? The final step in any writing process is testing. What makes sense to you might not make sense to the reader. A well-written document isn’t just technically correct; it...
When Writing Fails: Common Pitfalls That Hurt Usability
Technical writing isn’t about sounding smart—it’s about making things work. When users struggle, it’s rarely because they lack intelligence. It’s because the writing failed them. Here’s where things go wrong and what to do instead. 1. The Instructions Don’t Match...
The Flow of Documentation: Organizing for the User’s Mind
Have you ever opened a document and immediately felt lost? The information is all there, but something about the way it’s arranged makes it hard to follow. That’s a structuring problem, not a content problem. Good documentation doesn’t just give information—it guides...
Chunking, Lists, and Headings: Why They Work
Ever tried reading a wall of text and felt your brain shut down? That’s what happens when information isn’t structured properly. Good documentation isn’t just about words—it’s about how those words are arranged. Chunking, lists, and headings aren’t just formatting...
How Structure Makes Information Instantly Understandable
Ever opened a document and immediately felt lost? No headings, long paragraphs, and unclear flow—it’s a nightmare. Readers don’t want to hunt for information. They want answers, and they want them fast. Good structure makes information obvious. It removes the...
Step-by-Step vs. Conceptual Writing: Which One Works Best?
You've encountered technical writing if you've ever followed a recipe. This also applies if you've built furniture from a manual or attempted to troubleshoot a stubborn software issue. There are two primary types: step-by-step instructions and conceptual explanations....
Let’s Build Smarter Documents
Transform your documentation—from scattered content to strategic assets.
Whether you need a quick rewrite or a full system overhaul, we’re here to help you get it done right—the first time.