tl;dr: We can apply engineering methods to content development, but we do not have the body of proven algorithms or known-good data to justify formal certification of communication professionals the way we have for doctors and engineers. We talk about content engineering. I call myself a content engineer sometimes. But can content really be engineered? Is… Read More »
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 »
“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 »
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 »
It is often appealing to think of technical communication as a process of answering user’s questions. The difficulty with this view is that one answer can have many questions. If you answer each of those questions, you would be providing substantially the same answer over and over again. This is very easy to see on StackOverflow,… Read More »
In our data-driven age, we tend to give short shrift to story. Story tends to get herded off into the ghetto of drama. Story is for amusement; at work we stick to data. When I wrote my last post, suggesting a switch of terminology from “content” to “story”, many people naturally interpreted story as meaning drama.… Read More »
We used to be in the writing business. Then we were in the communication business. Now we are in the content business. It’s probably getting time to change the monika again. I have a candidate: “story.” There have always been two schools of thought about the word “content”. Some love it. Some hate it. I… Read More »
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 »
It is easy to think of metadata as a few information fields that you tack onto an article when you submit it to a CMS. In this vision, metadata is something fairly small, a triviality in comparison to the content itself. The reality is just the opposite; for any piece of content or data, the… Read More »
When I started my career in tech writing, it was the age of the writer. Tech writers tended to work independently on a single book for months at a time. Better, for many, they not only got to write the book, they got to design it and shepherd it through the publication process. At the… Read More »