This week I read a post by Ivan Walsh of I Heart Tech Docs entitled “Who Makes The Most Money—Technical Writers with Strong Language or Deep Technical Skills?” For some reason, his site won’t let me comment, but since it turned out that my reply was somewhat lengthy, it’s better to respond here in my own space instead of imposing on his.
At first, Ivan seemed to be saying that technical skills are more important than writing skills. But I read the post again, and I think he’s saying that technical skills are worth more in the marketplace because they’re harder to develop.
My take is that the reason a developer who does some tech writing gets paid more than the full-time tech writer is because the first guy is still a developer. Developers get paid more than technical communicators most of the time (or all the time, most likely). I think a programmer with some interest or a bit of practice in technical writing getting a job ahead of experienced technical writers may be a signal that management (or HR) doesn’t know what they’re supposed to be looking for in a technical writer.
Which Skills Are Easier to Develop?
Ivan attempted to draw a conclusion about whether language and writing skills are easier to develop than technical skills. I don’t think you can make a blanket statement. Some people are going to pick up writing and language skills faster, and I think a lot of those people find their way into technical communication; but a lot of them also have some interest and skill in technical areas. Some may be equally adept at writing and technical disciplines. I consider myself pretty good at writing, but while I struggle sometimes with technical concepts, I see myself as a quick learner.
The skill of learning quickly is one that should always be sought in a technical communicator. We constantly need to be learning—the product we’re documenting, some new tool, and so on. If you’re flexible and can learn quickly, I think you’ll go farther than someone heavy on writing skills or heavy on technical skills but not proficient in both.
I have heard many times that employers are more interested in soft skills than tool knowledge because they can send you to a few days’ worth of tool training, and you come back fairly proficient. But it can take a lot longer to learn the many things that effective technical communicators know.
Perpetuating the Myth
To accept the idea that someone with great technical skills and mediocre communication skills makes a great technical writer is to accept that anyone can write, which is a fable that many people tell around the campfire. And while anyone can type, not everyone can write well, or might I say, communicate effectively. There is so much more to technical communication than putting words on a page.
If you want good technical writing, get someone who knows how to communicate well. That takes both talent and training. It’s not something a developer is going to pick up after a couple of classes or an evening of practice unless he also has a talent for it. Even talented writers still have to practice a lot to do it well.
One of the big problems in our field is developers writing documentation when they don’t know what the ingredients of good user assistance are. As a group, they confuse telling the capabilities of the product with explaining how to use the product to get a job done. (Some of us do the same thing, so how can we expect developers to do any differently?)
Communication That Solves Problems
I argue that for effective communication, you need an effective communicator. Someone who can communicate with the developers well enough to understand the product and who can turn around and communicate effectively with the consumer. Depending on who you are, I don’t think those skills are easier to learn than how to code some JavaScript or to understand the difference between a primary key and a foreign key in databases.
But I do agree with comments after Ivan’s post—that if you broaden your view and look at how effective communication solves problems, then you’ll become more important to the team. And that means the project managers and developers will be coming to you to solve problems that the developers can’t solve.
Related posts (auto-generated):
- Could Technical Communication Be Entertaining?
- Technical Communication Can Require Heavy Duty Hardware
- Five Skills for Managing Documentation Projects in an Agile Environment
- Two Thoughts for Unemployed or Underemployed Technical Communicators
- Four More Reasons Your Company Needs Technical Communicators
Journals by Email












Ben Reply:
February 13th, 2010 at 4:22 pm
Strangely enough, I had trouble posting before you went to two blogs, too. I’m not sure what the problem is. I was using IE7; could there be a browser problem?