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'.
Every person has secrets that only he or she knows,... Read More
One of the most important priorities of evey online business... Read More
Anyone who's ever tried marketing IT products or... Read More
Lets start with copyright infringement.It is easily explained as copying... Read More
When you're writing or evaluating copy for a B to... Read More
It's a common approach to writing copy. You begin by... Read More
Many of us have been asked to write an article... Read More
What ever happened to good old fashion, fundamental copywriting? Has... Read More
So You Want To be A Copywriter?Wannabe copywriters often check... Read More
Professional copywriters are well-familiar with what's commonly referred to as... Read More
A significant reason behind websites that fail is the lack... Read More
How does this sound?Today, I'm going to show you how... Read More
Overlooking simple steps such as proofreading and grammar can affect... Read More
As websites and electronic commerce are becoming more and more... Read More
One of the best marketing tools available to your internet... Read More
"It's the headline, stupid," is the sign that hangs over... Read More
Persuasive copywriting is what draws the attention of prospective customers.... Read More
Did you know that jobs writing about food are available?... Read More
Sometimes learning what not to do is as important as... Read More
Did you ever wish you could afford to hire one... Read More
Year after year people make the same mistakes in direct-response... Read More
If you find that your progress is blocked by a... Read More
While traditional marketing can work for the book author or... Read More
1. Address your reader as a friend, not as "Friend."When... Read More
If you own a shop in the middle of the... Read More
Each weekday during my Red Hot Copywriting Bootcamp, attendees (or... Read More
I went to Google and entered a couple of different... Read More
It is important in this new paradigm of political correctness... Read More
Freelance writers are a strange group of people when it... Read More
Copy is all about words. Or is it?Copy is about... Read More
When you want to sell something?anything? you need to first... Read More
Your initial freelance writing assignments are the best way to... Read More
So many copywriters think that it's enough to be a... Read More
Just as great fiction is an art, so is great... Read More
Lets start with copyright infringement.It is easily explained as copying... Read More
When you want to sell something?anything? you need to first... Read More
In its most basic form, copywriting is, among other things,... Read More
One thing all successful Internet marketers have in common is... Read More
IntroductionA pencil. Yes, a pencil. In my opinion, every great... Read More
Careers in copywriting are booming. Could it be that the... Read More
Many people feel they have a story to tell or... Read More
Hi {FIRSTNAME Friend},Next time you're flicking through your local newspaper,... Read More
An interesting debate is currently raging among copywriters, web designers... Read More
How does this sound?Today, I'm going to show you how... Read More
Here's another drill ripped out of the Field Guide for... Read More
Most of us spend our days persuading others to buy... Read More
Whether you're an executive or a small business owner, chances... Read More
Overlooking simple steps such as proofreading and grammar can affect... Read More
You have a choice. Do you want to be constructive... Read More
The field of proofreading is not as easy to get... Read More
Many of the solo professionals whom I coach are people... Read More
When making a purchasing decision, people have their "rip off... Read More
One of the biggest challenges a copywriter faces is to... Read More
Not everyone is a writer. Good copy writing is a... Read More
Is it out there? The chance to be a freelance... Read More
I want to tell you how I go about writing... Read More
All the world's a story. Video games have storylines; newspapers... Read More
Copywriting ChecklistOkay, you know you have your product (or service)... Read More
1. Use a hand written letter on your ad copy... Read More
In a previous article I talked about a few similarities... Read More
As with any business, becoming a freelance business plan writer... Read More
WHAT'S THEIR PROBLEM?How do you begin a dialogue with a... Read More
I know, I know. Times are tough. You have to... Read More
In part one of this article series we began looking... Read More
Writing a killer headline for your copy is simple! You... Read More
You've probably seen web sites with testimonials - they can... Read More
Copywriting |