10 tips for tech writers

Posted On 2011-07-17 by FortyPoundHead
Tags: General Tip 
Views: 632

Tech-writing is a tricky business. It s not a very high profile industry, so there s not much support around. Follow these 10 quick tips, and you ll be well on your way to a satisfying tech-writing career.

  1. Follow a sensible career path:
    • STEP 1: Start in a team
    • STEP 2: Stay only just long enough
    • STEP 3: Manage yourself
    • STEP 4: Manage a team
    • STEP 5: Go contracting (depends on the market)

  2. Knowledge is your lifeblood learn the politics of your company. Know who knows what. Find someone who consistently gives you timely, reliable, technically accurate answers, and get their name tattooed on your shoulder! Every company has at least one. And they may not be in the project manager/product manager/customer/programmer roles. They are generally the people who ve used the product in the real world, and dealt with real world customers.

  3. Communicate WITH, not AT. Tech-writers don t have enough power to get away with communicating at.

  4. Track stuff (take spreadsheet printout and write it up on the board).

  5. Develop good product and domain knowledge The more you can figure out for yourself, the better off you ll be (and the more respect you ll get from the techies).

  6. Find out who your users are, what they are trying to do, what they are having trouble doing, and how they want to be helped. Then provide this assistance. Help the user do what they are trying to do. Don t just tell them what the product can do a help system is only helpful if it addresses the users needs.

  7. Treat everyone as a customer. Then manage their expectations and your commitments. Always ensure they know what you re doing. Tell them when you ll be finished. And pull out all stops to meet your deadline.

  8. Provide a surrogate user testing mechanism for the development team providing usability feedback.

  9. Work as hard as required to get good quality doco finished on time and to budget this is how you ll get the satisfaction out of work that you need.

  10. Have fun with it.

Don't become jaded and cynical by the high-tech, harsh, uncaring IT world. Use your smarts, and make the most of the resources provided. Most importantly of all, make work satisfaction your number 1 goal. It s the best way to stay happy and get ahead.

About the Author

FortyPoundHead has posted a total of 1974 articles.


Comments On This Post

No comments on this post yet!

Do you have a thought relating to this post? You can post your comment here. If you have an unrelated question, you can use the Q&A section to ask it.

Or you can drop a note to the administrators if you're not sure where you should post.

Your IP address is:

Before you can post, you need to prove you are human. If you log in, this test goes away.

Beat With A Stick List Returns: By request, BWASL has returned to the site. Free your rage by telling the world about something that really grinds your gears. Add your beating.

Recent Forum Posts

BWASL returns
dwirch posted on May 13, 2017 at about 15:24 in Site News

BWASL returns
dwirch posted on May 13, 2017 at about 8:46 in Site News

Job Spammer: Balashankar Bose Bose
dwirch posted on May 11, 2017 at about 10:05 in Spammers

Job Spammer: Bharti Jigyasi
dwirch posted on May 11, 2017 at about 7:58 in Spammers

List of Shady Characters
dwirch posted on April 25, 2017 at about 16:39 in Webmaster Stuff

Job Spammer: Bilal Uddin
dwirch posted on April 25, 2017 at about 11:00 in Spammers