Writing Excellence Through Domain Awareness

A little while back, Tom Johnson posted an article entitled Seeing things from the perspective of a learner in which he says, “The balance between knowing and not knowing is the tension that undergirds the whole profession of technical writing.”. I think that is absolutely correct. The point, after all, is to assist the reader on their… Read More »

What is an “Expert Writer”?

“Hire Expert Writers,” Says Google That is the title of a post from M2Bespoke about Google’s emphasis on returning reputable content. What is an “expert writer” in this context? Many of those who have commented on it and passed it around take it to mean expertise in writing. That seems to be the interpretation that… Read More »

Why does XML suck?

XML sucks. Don’t get me wrong. All kinds of really valuable and important systems use XML to perform vital functions. But performing a vital function does not keep something from sucking. Lots of people think Windows sucks, but it performs a vital function, and lots of people use it because of that. In fact, performing a vital… Read More »

Is There a Reproducible Method for Explanation?

In a recent LinkedIn discussion on “Most important competencies for technical writers,” I commented that the most important skill for technical writers was explanation, and that the ability to write and the ability to explain are not the same thing, and that the ability to explain is significantly less common that the ability to write… Read More »