MH | Thought Pieces.

Thought Pieces.

All articles – from new ideas to older content worth exploring.

A person sits thoughtfully in front of a laptop, its screen showing an error message and an open documentation tab — both saying the same thing, neither explaining what to do.

Technically Correct, Practically Useless.
◆ Beyond Buzzwords

Documentation often inherits the developer’s perspective — untranslated, unquestioned, just passed along. This isn’t a writing problem. It’s a translation problem.

A frustrated person sits with their hands on their head in front of a laptop, flanked by two documents: on the left, an unreadable, convoluted diagram; on the right, a clearly structured step-by-step guide. A glowing arrow points from the chaotic to the organized document — a metaphor for the difference between confusing and helpful documentation.

When Help Gets in the Way.
◆ Beyond Buzzwords

The problem isn’t too little information — it’s too much of the wrong kind. Three scenarios that show why complete and helpful are two very different things.

A person asks a question while a librarian sits behind an overwhelming stack of books—a metaphor for the challenge of finding the right answer from vast amounts of information.

Garbage In, Garbage Out:
Seven Myths About LLMs—and What's Really Behind Them.

Poor results from LLMs almost always share the same root cause: wrong expectations, missing context, unclear prompts. The problem isn’t the technology. It’s how we use it.

Laptop with open book from which colored arrows emerge as information streams.

Rethinking Technical Documentation:
Why Information Developers Are More Than Writers.

Technical documentation is yesterday—information development is the future. Why I don’t just document, but strategically develop knowledge.

Illustration of three people in dynamic discussion, surrounded by speech bubbles and symbols.

Intelligent Documentation:
Relevant Content at Just the Right Moment.

Good documentation convinces not through length, but through relevance. Less is more when it’s clearer, more precise, and to the point.

Workspace with notebook, pens, and a laptop, overlaid with digital code lines.

Ready for the Cyber Resilience Act?
Your Documentation Could Make the Difference.

The Cyber Resilience Act requires you to understand risks—and your documentation to explain them.

A wooden signpost with three blank signs at a fork in a picturesque landscape.

Technology Meets Language:
My Path to Information Development.

Sometimes we must take detours to recognize where our skills can make a difference.

Illustration of a futuristic robot pointing at a digital folder browser displaying various folders and files. Symbolizes the automation of routine tasks through AI in technical documentation.

Offload Routine, Gain Time:
How LLMs Support Technical Documentation.

Is AI pulling the rug out from under technical writers? No—it’s building the foundation for their future.