Want Respect? Get out of Publishing

I recently wrote the following in a comment on Tom Johnson’s blog post What Tools Do Technical Writers Use:

That writers are still expected to do their own publishing strikes me as one of the tragedies of the profession, and a major part of why tech pubs does not get the respect it thinks it deserves in organizations. It is a big part of the reason that so many people still dismiss what tech pubs does as “making it pretty”.

It was not the most deeply considered statement I have ever written, and when I read it over after having posted it, I rather wondered at the sentiment it expressed. Why exactly should engaging in publishing lose you respect? It’s not as if people universally lack respect for publishing. It’s not as if publishing is something akin to pyromania or politics, rightly despised by all. Yes, there is the “making it pretty” thing, but why exactly should the ability to make content pretty lose you respect? People are not generally opposed to pretty. They like pretty. They pay a lot of money for pretty. read more

Why documentation analytics may mislead

I was rereading some material in the long-running do-people-read-the-manual debate (such as Tom Johnson’s If No One Reads the Manual, That’s Okay), and it struck me that there is an assumption that people on both sides of this debate are making which deserves some scrutiny. We all assume that technical documentation operates at first hand. That is, we assume that when a user wants help, they get that help directly by reading the manual or the help system or by watching a video, etc. I don’t think that assumption is correct. In fact, I’m convinced that it is naively and dangerously wrong, and that measurements and decisions based on this assumptions may be fundamentally flawed and harmful to a company and its customers. read more