Tech-writers: A Necessary Evil
New to tech-writing, or thinking about starting? The key to success is recognising that tech-writers are a necessary evil.
Tech-writers are necessary because someone has to write the user doco. The programmers and managers sure as hell don't want to. This is actually part of the reason that you're evil, too. In my experience, most programmers and managers think that they could write the manuals if they wanted to? they just don't want to. They might not write all "flowery" like the tech-writers, but what they write is correct.
Unfortunately, that's quite often all that's important to programmers and managers.
There is a feeling within the software environment that accuracy = quality. Audience analysis, doco readability, consistency, usability, active and passive voice, commas in a list of three or more items? All of these things are relatively unimportant to everyone but the tech-writer. Oh? and the user.
In a world where accuracy is all important, a lot goes over the head of the dummy. I don't know if it's intellectual snobbery, but programmers and managers seem to think that if they understand it, so should the user. It doesn't matter whether or not they do? they SHOULD! Stupid users! Maybe it's the geek's ultimate revenge?
Your document can be 100% accurate, but if the audience can't read it, you've wasted your time.
So why doesn't anyone acknowledge this? They do! That's the weird part. In theory, everyone agrees with you, it's just in practice that you find yourself out in the cold. I don't know why this happens. Maybe it's because most of these guys have never done tech-writing.
So tech-writers spend too long worrying about unimportant things. And they bother programmers and managers with unimportant things. But they're necessary things. Otherwise why would you be employed. Maybe the absence of simple logic short circuits their brains. Who knows?
What we can get out of this is that there's a feeling that tech-writers waste time, and as a result, they're pretty much at the bottom of the heap in the software world. I think a good analogy is the way some rich see the poor. Dirty little creatures? if only we could do without them?
But there is an up-side. I don't want you thinking it's all bad.
Being at the bottom of the heap has its advantages. You can go unnoticed for years if you want. If you haven't seen the movie, Office Space, you should hire it. There's a little ferrety bloke in that who was "let go" years ago. Problem is, no one ever told him, and because of a glitch in payroll he still got paid. No one ever noticed.
Being a tech-writer's a bit like that.
When I was managing doco teams, my favourite saying was "All we have to do is manage their expectations and our commitments". Because programmers and managers resign themselves to the fact that they don't know what's going on in the doco team, there's sometimes a temptation to slacken off. Don't give in to this temptation!!! If you ever get caught, doing it, it'll be like the boy who cried wolf ? they'll never believe your estimates again!
The other risk is that you'll lose your sense of urgency. And that's a big part of what makes a good worker. You should be very strict about managing your commitments. This requires discipline, because sometimes it seems you're the only one that cares, but you have to do it.
One thing you should be aware of though, is that your average tech-writer in software spends only about 50% of his or her time writing. The rest of your time is spent planning, problem solving, fixing your computer, researching, interviewing the programmers, writing work pracs?
I always found it was a good balance, though.
It was when I started managing teams that the bottom really fell out. Then the percentage dropped to about 10-20%. There were times when I'd go months without writing any help at all. That can be very frustrating, especially if you don't particularly like managing.
Now managing tech-writers in software is an interesting thing. As with most technology management positions, you kinda fall into it, because you're the most senior/experienced person in the company. Unfortunately, that doesn't qualify you to be a manager. Software companies are renowned for dumping people into management roles without any real training or support.
I don't really have any advice for you here. If it's gonna happen, it'll happen. Just be aware of it, and know that if you fall into a management role, it's gonna be difficult. (That's not to say that it can't be rewarding though?)
The ironic thing is that the most difficult aspect of it is that your staff are screaming at you to change the system. "The programmers don't answer our questions!" "None of my work has been reviewed for the last 2 months!" "The project manager just told me to forget about quality!"
Unfortunately, the inexperienced tech-writer is often naïve enough to think they can change the system. Once you become a manager, you know you can't. Hold on a minute? Maybe apathy is what qualifies you to be a manager? Hmmmm.
In any case, my advice is not to push too hard. You'll make life hard for your manager, and give yourself a bad reputation. Recognise you're a necessary evil, and work within those constraints.
Tech-writing can be a lot of fun. And don't let anyone tell you it's not creative. Trying to think of a way to describe what goes in the Name field without just saying "Enter the name" is a real mind-boggler!
About The Author
* Glenn Murray is an SEO copywriter and Article Submission Specialist. He is a director of PublishHub and also of copywriting studio Divine Write. He can be contacted on Sydney +612 4334 6222 or at glenn@divinewrite.com. Visit http://www.divinewrite.com or http://www.publishhub.com for further details, more FREE articles, or to purchase his e-book, 'SEO Secrets'.
 Google News Updated : Thu, 24 Jul 2008 06:51:44 GMT Karadzic lived the good life with wine, song - Reuters
Reuters - By Ivana Sekularac BELGRADE (Reuters) - Radovan Karadzic lived the good life while hiding from justice for 11 years: he watched his diet, fell in love and hung out in a small bar where hardliners gathered to sing about his wartime exploits. Video: Karadzic's arrest sparks clashes - 23 Jul 08 Karadzic's secret life enthralls his fellow Serbs Publ.Date : Thu, 24 Jul 2008 04:05:33 GMT Zimbabwe Parties May Sign Unity Deal Soon, Business Day Reports - Bloomberg
Bloomberg - By Carli Lourens July 24 (Bloomberg) -- Zimbabwe's ruling and opposition parties may sign a power-sharing agreement soon as they have already agreed on a wide range of issues, Business Day reported, citing people it didn't identify. Fearsome Zimbabwe militias are afraid Delayed Zimbabwe Power-Sharing Talks Seen Beginning Thursday Publ.Date : Thu, 24 Jul 2008 06:23:06 GMT Billionaires Back Antismoking Effort - New York Times
New York Times - Bill Gates and New York Mayor Michael R. Bloomberg announced their antismoking initiative on Wednesday in New York. By DONALD G. MCNEIL JR Bill Gates and Mayor Michael R. Bloomberg announced on Wednesday that they would spend $500 million to stop ... Video: Gates, Bloomberg Pool Riches to Fight Smoking The $500 million war on smoking Publ.Date : Thu, 24 Jul 2008 06:23:48 GMT Christian Bale's lady sidekick: Sibi Bale - Los Angeles Times
Los Angeles Times - Like the Dark Knight/Bruce Wayne, Christian Bale is a real-life man of mystery. Averse to personal publicity, he is well-known for not wanting to discuss his private life. Christian Bale, Wife "Solid" at Knight's Spain Premiere Bale's family feud led to scuffle Publ.Date : Thu, 24 Jul 2008 02:10:31 GMT Rapper 50 Cent sues Taco Bell over ad - New York Daily News
New York Daily News - BY THOMAS ZAMBITO The rapper - real name Curtis Jackson - is suing the fast-food chain for using his hip-hop persona to tout its tacos. 50 Cent sues Taco Bell over ad campaign Rapper 50 Cent says Taco Bell stole his endorsement Publ.Date : Thu, 24 Jul 2008 06:15:09 GMT Favre's heir? With backing from mates, Rodgers waits patiently - USA Today
USA Today - By Matt Ludtke, AP By Larry Weisman, USA TODAY He no longer sounds like a retired player after seemingly passing on the opportunity to lead a talent-laden Packers squad. Video: The Rift Between Favre and the Packers Finding new home for Brett Favre won't be easy Publ.Date : Thu, 24 Jul 2008 02:06:18 GMT Discovery may boost statin safety - BBC News
BBC News - Scientists have pinpointed a gene mutation as a major cause of a rare side effect of the cholesterol-lowering drugs statins. They hope the discovery could lead to a simple test to identify patients at increased risk of myopathy - severe muscle pain and ... Gene May Predict Cholesterol-Lowering Drug Risk, Study Says Genetic Cause of Statin-Related Muscle Pain Found Publ.Date : Wed, 23 Jul 2008 23:14:24 GMT Automatic Blogging |
PARLOT::Ebooks, Scripts,
Websites, and more... About once a month I fly off somewhere to give... Read More You've done it. Gotten that press release written. Now you're... Read More Have you seen those copywriting gurus, working it on the... Read More So, you have something you want to sell. It may... Read More In part one of this article series we began looking... Read More Just as great fiction is an art, so is great... Read More When you come to 'know' something, there is a temptation... Read More In order to maximize your sales efforts and fully seize... Read More Copy is all about words. Or is it?Copy is about... Read More Site visitors generally stay with you for as long as... Read More Have you ever had the experience of hiring a freelance... Read More "Shallow men believe in luck. Strong men believe in cause... Read More Writing headlines for your ads is the most important part... Read More From the early days of search engine optimization, keywords and... Read More Only about 20% of your copy is going to get... Read More All the world's a story. Video games have storylines; newspapers... Read More When I critique, edit or rewrite sales copy, I discover... Read More Market identification Custom writing services market is a sector of... Read More Most of us spend our days persuading others to buy... Read More As a freelance copywriter in New York, your work is... Read More How does this sound?Today, I'm going to show you how... Read More Most of the sales pieces people ask me to rewrite... Read More Writers write just like painters, paint on canvas. This is... Read More Now that your website is up and running, it's time... Read More Sometimes learning what not to do is as important as... Read More
Adsense
websites
Writing Online In Two Syllables or Less
Are You Making These Press Release Mistakes?
The Secret to Web Copywriting Gurudom
How To Write Direct Mail That Really, Really Works!
Copywriting Makeover: Making An Emotional Connection - Part 2 of 2
Its Time To Start That Swipe File
Welcome Informed Criticism of Your Work
Power Keys To Writing Power-Packed Marketing Copy
Its Not What You Say But How You Say It
Fill Your Readers with Confidence
Copywriter Rates, Getting The Facts Beforehand
Cause and Effect
Impulse Writing for Better Ad Headings
Does Your Copy Look Fake To the Search Engines?
Five Sections of Your Copy Guaranteed To Get Read
Three Steps To Pump Up The Drama In Your Copy
Boost Your Conversion Rate In Three Steps
Custom Writing Services: Market Overview
Better Copy: The Interview is the Key
How To Become A Freelance Copywriter In New York
The Number One Copywriting Technique That Makes Your Prospects Read Every Word You Write
The Biggest Mistake Copywriters Make
To Start Making Cash from Your Online Writing, You Must Draw Blood First
Writing Tips for Your Website
Common Mistakes That Can Kill Your Web Copy
Affordable and Reliable Web Hosting Starting at $4.49/Month
How to Build Benefits from Features Fast and Easy with the Solution Approach
Every salesperson and fledgling copywriter hears the harangue: DON'T SELL... Read More
Power Words And Phrases
I like to use power phrases when writing sales material.... Read More
3 Keys to Better Online Copywriting
Doing the copywriting for your own website without the proper... Read More
Writing Tips for Your Website
Now that your website is up and running, it's time... Read More
Sowing the Seeds of Opportunity: How to Multiply Your Freelance (Writing) Work
You can turn your $200 fee to write a press... Read More
Quotations as Expressions in Life
Quotations are expressions, usually in the spoken form or in... Read More
Welcome Informed Criticism of Your Work
When you come to 'know' something, there is a temptation... Read More
Five Sections of Your Copy Guaranteed To Get Read
Only about 20% of your copy is going to get... Read More
How to Hold Peoples Interest throughout those Long Copy Sales Letters
People tend to read your ads and sales letters in... Read More
Knowing Copywriting Basics - How To Get Ahead In Your Copy Writing Business
In order to get ahead in your copy writing business,... Read More
How Cliffhanger Paragraphs Capture Readers
About 50 years ago, movie serials kept theater crowds coming... Read More
Should You Use Testimonials When You Create A Web Site?
You've probably seen web sites with testimonials - they can... Read More
Five Tips for Writing Eyeball-Grabbing Headlines
If you made it this far, the headline for this... Read More
Writing Copy for Voiceovers
As with any of the performing arts, an effective voiceover... Read More
Website Promotion: 10 Secret Motivational Triggers That Make People Buy
Unless you know the secret motivational secrets that make people... Read More
How to Write Ad Copy that Sells
When I write copy for my advertising clients, I always... Read More
How to Write a Sizzling Sales Letter, Part 1
When you sit down to write a sales letter to... Read More
Why You Should Write To Inform And Not To Sell
Advertising is key! Unfortunately most people waste their money on... Read More
The Formulas Freelance Copywriters Employ When Creating Web Content
What is it exactly that copywriters DO when they produce... Read More
How You Can Proofread Your Own Work
Putting out a high quality product is a given these... Read More
Steps to a Writing an Effective Press Releases
Want to get the most media attention and spotlight for... Read More
10 Tips for Writing Effective Web Copy
On the Internet programmers and designers rule, not the writer.... Read More
Segmenting Your Target Audience Through Your Copywriting
Ask any copywriter what the first commandment of copywriting is... Read More
Freelancers Can Jump-Start Your Publicity Initiative
If you find that your progress is blocked by a... Read More
5 Ways to Instantly Improve Your Copy
1. Isolation technique It doesn't matter how good your... Read More
Copywriting |