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 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...

Navigation Matters: Why Indexing and Search Are Critical

If users can’t find the information they need, your documentation might as well not exist. Searchability isn’t a “nice-to-have” feature—it’s the backbone of useful documentation. The best content means nothing if hidden. A mountain of text with no clear way to access...

read more

Task-Based Writing: Helping Users Get Things Done

You're troubleshooting a network issue. You open the documentation, and you do not find clear steps. Instead, you get a paragraph explaining how networks operate. It tells you what to do only after that. Not helpful. This is where task-based writing makes all the...

read more

The Silent Teacher: How Documentation Acts as a Mentor

When was the last time you opened a manual? Did it feel like you had a personal guide walking you through the steps? Probably not often. Most documentation reads like a rulebook—cold, rigid, and barely tolerable. But the best documentation does something different. It...

read more

Writing That Guides, Not Confuses: How to Lead the User

Bad Writing Wastes Time. Good Writing Gets Out of the Way. Technical documentation exists for one reason: to help people do something. If your writing makes them stop, re-read, or second-guess, it’s failing. Your goal isn’t to impress—it’s to guide. The user should...

read more

The User Should Never Be Confused: 3 Writing Fixes

Imagine opening an instruction manual. You expect quick guidance. Instead, you're met with vague steps, unnecessary jargon, and no clear path forward. You reread a sentence three times, still unsure what to do next. This is where bad technical writing fails—and where...

read more

Formatting as a Guide: How Layout Shapes Understanding

You’ve seen it before—long walls of text, no headings, no spacing, and no clear way to tell what’s important. It’s frustrating, slow, and makes even simple instructions feel like a chore. Good technical writing isn’t just about the words. It’s about how those words...

read more

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.