Suite101

Respecting Technical Writers


© John L. Hoh, Jr.

Technical Writers Deserve Respect – From Each Other

Technical writers are made up of complex individual personae. As a writer, you are expected to have knowledge of your subject. The more subjects you write about, the more knowledge you gain. (Supposedly.) Not every writer is like that, but most are, and they deserve to be congratulated for going the extra mile and actually learning a product they are going to write about. Most writers maintain knowledge about many systems and subjects, thus becoming an "expert" in the technical writing field.

There’s more to Writing than just Knowing How Something Works

So, as a Technical Writer, you know a lot of stuff. So you were around when all you had to document were mainframe programs and used SCRIPT. So, you have an English degree. So, you know how to dissect a sentence and name every part and participle. Singularly, each of those accomplishments is a wonderful thing. However, there is so much more to being a technical writer than just visible “technical skills.”

A fellow technical writers said it best: "..there are many other things that tech writers do that are much more deserving of respect - organizing a doc set, researching methods for effective communication, mastering authoring and publishing tools, researching and organizing product information from a number of disconnected sources, understanding the product and its overall application more than most other departments in the company etc. etc."

A good technical writer isn’t just a writer. They are a project manager, documentation specialist, researcher, communicator, mediator, and so much more. Good technical writers identify that within each other and recognize the effort.

Not Everyone Recognizes the Effort

In all the professions, I don't think I've seen it more evident than in tech writing: When one writer follows another on a project, the previous writer's work receives scathing editorial comments from the new writer.

A technical writer deserves so much respect, not just from managers and programmers and SME's and support personnel, but from other technical writers. We forget that we are a very rare breed. Be fair to the previous technical writer. You don’t know all of the circumstances that led to the writer leaving the contract or project. Even if the writing is atrocious or the organization and layout lack creativity, try to be objective. Gather the necessary materials and add your expertise to the project without tearing the previous writer down to make yourself look better.

"Man's greatest desire is not love or hate, but to change another person's writing." -- George Orwell.

Sure, there are bad technical writers just like there are bad managers and bad

Go To Page: 1 2


Post this Article to facebook Add this Article to del.icio.us! Digg this Article furl this Article Add this Article to Reddit Add this Article to Technorati Add this Article to Newsvine Add this Article to Windows Live Add this Article to Yahoo Add this Article to StumbleUpon Add this Article to BlinkLists Add this Article to Spurl Add this Article to Google Add this Article to Ask Add this Article to Squidoo


Here's the follow-up discussion on this article: View all related messages

4.   Oct 5, 2004 1:53 PM
from the "Dilbert" strip symbolizes this lack of respect, no? How often are dealines pushed back for the engineers designing the product--but the release date is the same and the product manager wonde ...

-- posted by H2O


3.   Jul 2, 2003 9:54 PM
Thanks for pointing out the plank in my eye.

-- posted by IndianTW


2.   Jul 17, 2001 3:48 PM
Hi, yes, unfortunately, the lack of respect is not company specific. But, we can change that. I hope that you can help change attitudes in your company. Good Luck! ...

-- posted by VMTWriter


1.   Jul 16, 2001 7:52 AM
Hi, I'm new to suite101. Just read your article on respect and just had to say it is soooo true. I thought it was only that way with my company. Guess it's like that everywhere. ...

-- posted by sirfrank5





Join the latest discussions

For a complete listing of article comments, questions, and other discussions related to John L. Hoh, Jr.'s Technical Writing topic, please visit the Discussions page.