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

---

SEO Copywriting: 7 Tips

So you finally built a website for your home-based business. How exciting is that!? Now you just have to let people know you're out there. The best... Read More

Lapsed Donors: How to Write a Fundraising Letter That Wins Them Back

Your definition may differ, but I define a lapsed donor as someone who has not donated to your organization within the last year, two years or three... Read More

Content is King

IntroductionA pencil. Yes, a pencil. In my opinion, every great idea has started with a pencil. Sure, lots stay in someone's head, but to me a great... Read More

Working With a Freelance Editor

If you are interested in creating information products, you will very likely deal with editors throughout your career. You may need someone to edit a book, review... Read More

Your Article Headlines will Make or Break Your Business

Most people with an online presence will have to regularly deal with the issue of coming up with an appropriate headline. The problem is that most people... Read More

Its Time To Start That Swipe File

Just as great fiction is an art, so is great copywriting. Beneath the art, however, there's a foundation of basic knowledge and skills. The craft that goes... Read More

Copywriter Rates, Getting The Facts Beforehand

Have you ever had the experience of hiring a freelance copy writer only to find that the project takes longer than expected, or that the fees they... Read More

Freelance Writers: Double Your Income

Freelance writers are a strange group of people when it comes to running their own businesses.They are outspoken and enthusiastic while selling their clients' products and services,... Read More

A Writers Secrets

Every person has secrets that only he or she knows, secrets that are not shared with anyone, not even the most intimate friends, partners, even soul mates.... 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... Read More

Freelance Copywriters on the Internet: How to Tell the Difference Between Heaven-sent and Hack

If you're hunting for a good freelance copywriter and have never done it before, or if you have but find yourself needing another for the first time... Read More

Prevent Procrastination With Positive Pressure

My wife and I recently bought a house.It's currently being built and moving day is slated for December. So we decided to buy some furniture in order... Read More

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... Read More

10 Things You Should Expect From Your Website Copywriter

As websites and electronic commerce are becoming more and more common, business owners and marketing managers are realising that quality web copy is every bit as important... Read More

A Copywriting Lesson from Dr. Seuss

Looking for inspiration for your next marketing communication? Try the children's bookshelf.Dr. Seuss has entertained young (and old) audiences for nearly 50 years with titles such as... Read More

Writing Benefit-Driven Web Copy ? 4 Steps to More Sales

You've identified the benefits you offer your customers, but how do you turn a list of benefits into engaging web copy which converts visitors into customers?Recently I... 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... Read More

Copywriting for Astrology, Numerology, Tarot, and the Mystic Audience

These days, you don't have to traverse the dark forest on the eve of the Full Moon to find a gypsy, psychic or "intuitive" as many now... Read More

Four Simple Steps to Improve Your Sales Copy

You know what it's like, you're reading the sales material about a product you're considering buying, but, as you read, all these questions seem to pop into... Read More

The Lead: Sinking The Hook Into Your Prospect

You only have an instant to capture your prospect's attention. No matter the medium ? a sales letter, print ad, or commercial ? she's going to make... Read More

10 Eye Popping, Jaw Dropping Ad Copy Secrets

1. Use a hand written letter on your ad copy instead of text. Write the ad on a piece of paper, scan it and publish the ad... 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."... Read More

No-Holds-Barred Conversation with Dan Lok - Part 1

Question: If you were starting out and had no references or a substantial resume, how would you go about finding paying customers for your services?To answer your... Read More

Writing Tips for Your Website

Now that your website is up and running, it's time to add content. Fresh content will make your site interesting and keep people (and search engine crawlers)... Read More

How to Write Adverts that Forces People to Respond

Think for a moment some day and consider the kind of advertising you see in your post box, on the TV, on your computer, on the radio,... Read More

How Your $2-an-Article Ghostwriter is Like a Cheap Pair of Pants

Web marketers: have you figured out that article marketing is the secret to your success on the web?And did you realize that the more web articles you... Read More