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'.

---

When Panic Attacks Writers

If you write for a living, you deal with deadlines. Sometimes you will have several jobs on your plate at the same time.On top of that, your clients or editors don't coordinate their... Read More

Writing Great Website Sales Copy

Many small businesses fail because their owners don't pay enough attention to marketing and sales. Part of the effectiveness of a marketing effort is directly related to the sales copy you produce. This... Read More

Touching the Prospect?s Emotions in Your Sales Letter

Your prospect has emotions? and you MUST touch these emotions in your sales letter. Your copy has to excite. Stir curiosity. Generate fear. Create deep desire.If it doesn't your copy will fail.The reason... Read More

3 Ways to Increase Conversion Rates

In a previous article I talked about a few similarities between writing direct mail packages and writing web sites. In short, I concluded that as online writers we could learn a lot from... Read More

Kick-Start Your Juices

Listen, consider this scenario.You have a deadline to honour. Time is pressing, tighter and tighter. You are hoping to come up with some topic for your project.....However, ideas on what to write about... Read More

Deciding What Voice to Use in Copy

You have to choose a character or an angle that you, the copywriter plays. Copy is interactive. There's a copywriter and a copy reader. As soon as one is gone, the relationship is... Read More

Why Is FREE The Most Powerful Marketing Word You Can Use?

As the famous cowboy Will Rogers once said, "Even if you're on the right track, you'll get run over if you just sit there".So what does that have to do with "FREE"? Quite... Read More

Better Copy: The Interview is the Key

Most of us spend our days persuading others to buy our service, product or idea. Here is how to create powerful marketing copy to make your job easier: INTERVIEW YOURSELF.If you hired a... Read More

How to Write Carrot-Wielding Copy!

A significant reason behind websites that fail is the lack of an effective direct response sales message. Such a message is comprised of three elements (it must be):Captivating (it captures the reader's attention)... Read More

Sticky Homepage Copy in 30 Seconds

Yes indeed, that's all you've got, 30 seconds to make your website visitors decide to stick around...The internet has changed how we think about the customer, the product and the competition. I'm going... Read More

Grammatical Mistakes DONT Sell

When you receive a sales letter with typos or grammar mistakes in it, do you take it seriously? Probably not. As soon as I see a few eighth-grade English blunders in any marketing... Read More

Dissolving Buyer Scepticisim ... A Lesson In Copywriting

When making a purchasing decision, people have their "rip off radars" on high beam. They're wary and so they should be -- after all, they're about to spend money so they want to... Read More

Pulling Sales with Your Ad Copy

One of the best marketing tools available to your internet business is good sales ad copy. This can pull in sales faster than just about anything.If you're not a writer or cringe at... Read More

How to Start and Sustain a Career as a Freelance Writer

Have you wondered how you can make a career writing books or articles for various publications? Or are you seeking a viable second income opportunity but do not know where to start? Well,... Read More

Hey, Client, This Is Me! Sell With Your Writing Voice

In a crowded market, clients will be seeking personality as they read what you've written -- they'll click right past pages that feel "been there, read that." They're looking for a voice that... Read More

How To Really Connect With Your Customer In Your Copywriting

One of the least talked-about areas in copywriting education is voice. This is probably because it's tough to set general rules for something that's so personal to each of us. After all, the... Read More

The Write Way To Grow Your Business

Hone your writing skills to project a more professional business image.The sales letter you can't put down?the advertising copy that makes you want the product?the resume that prompts you to call the job... Read More

?Super Adjectives? Boost the Power of Your Copy

Pretty or elegant? Good or scrumptious? Nice or delightful? There is power in the adjectives you choose. Just like Clark Kent and Superman or Bruce Wayne and Batman, some adjectives are plain, ordinary,... Read More

Freelance Technical Writers - How Much Are You Worth?

Where can you find out about freelance technical writing pay? Is there a place where you can go and find out where you stand? As with any field, pay is determined by several... Read More

How To Write Powerful Headlines

I want to tell you how I go about writing headlines. I like to keep swap files of headlines around for future use. And how I go about doing it goes something like... Read More

Five Sections of Your Copy Guaranteed To Get Read

Only about 20% of your copy is going to get read. The rest will simply be scanned. I'm sure you've heard the statistic before. It's nothing new. While it might sound frightening or... Read More

Knowing Copywriting Basics - How To Get Ahead In Your Copy Writing Business

In order to get ahead in your copy writing business, you need to know copywriting basics. There are several things that all business owners need to know, and here, we will touch on... Read More

Copywriting Makeover: Making An Emotional Connection - Part 1 of 2

One statistic shows that over 80% of all buying decisions are emotional. That means your copywriting should be, too. This is something I firmly believe in and have preached for most of my... Read More

Boost Your Conversion Rate In Three Steps

When I critique, edit or rewrite sales copy, I discover that many clients commit common errors. Granted, not all of them are writers. But most of them fail to drive customer actions not... Read More

Sowing the Seeds of Opportunity: How to Multiply Your Freelance (Writing) Work

You can turn your $200 fee to write a press release into $2,000 to carry out an entire PR campaign simply by convincing clients to invest in campaigns, instead of individual assignments. Campaigns... Read More

Copywriting and Your Five Senses

In its most basic form, copywriting is, among other things, the art of conveying a message in writing for the purpose of persuading someone to do something. This is especially true when writing... Read More

How To Ethically Use A Swipe File For Your Ad Copy

Did you ever wish you could afford to hire one of those professional copy writers who charge $5000 or more to write a simple sales letter? Or worse, have you laid down your... Read More

Impulse Writing for Better Ad Headings

Writing headlines for your ads is the most important part of your online presence.When posting your ad to classified sites, directories, message boards, newsgroups or mailing lists, the only part of your ad... Read More

Help, Help, Help, Sell

Here's a fundamental difference between copywriting offline and copywriting for the web... - Give or take, my job as a copywriter offline was to sell, sell, sell, sell. - Online, I think, my... Read More