| |
| |
|
Mahavir Information |
| ||||||||
|
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'.
MORE RESOURCES:
Acne - Google News |
|
|
|
RELATED ARTICLES
Increase Freelance Sales With an Online Resume! Freelancing is a competitive business, especially in today's fast-paced, e-focused world.Often there are hundreds of writers competing for the same, limited number of assignments, and the writer who can best showcase his or her abilities is the one who lands the job. 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. 13 Steps to a Slippery Slope Online Sales Letter Many of the solo professionals whom I coach are people who offer services. They're coaches, consultants, creatives. Web Copy - How Much is Enough? These days, there's widespread acceptance that a website is an integral part of the marketing plan of any business. Likewise, it's commonly accepted that web copy is a vital component of any website. 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. Subtle Emotion - The Key To Copy That Works Say the word "emotion" to a man, and he'll immediately jump out of his seat and run from the room! Utter the word "emotion" to a woman, and she begins to conjure up thoughts of romantic, long talks centered around feelings. However, speak the word "emotion" to a copywriter and s/he should see dollar signs. How Writing Radio Can Help You Become a Better Writer Knowing how to write, and write well, is a skill that will come in handy in all sorts of situations. And if you combine good writing skills with the persuasive selling tactics found in, say, copywriting, you'll be that much more ahead of your competition. Writing Online In Two Syllables or Less About once a month I fly off somewhere to give a one-day workshop on writing for the web. For part of the day, I invite the group to take part in a series of short tasks. Headline Writing Can Lead To Fortunes: Here Are The Basics Of Writing Headlines Headlines attract attention. Headlines generate interest. Top 10 Ways For Copywriters To Overcome Writers Block We all know that words have the power to persuade, compel and most importantly, sell.However, many have likened the process to getting the 'right words' to trying to get blood from a stone. Designing for a Non-English Audience Having worked as a digital publishing specialist at a large corporation at my previous job, I did not think being in charge of foreign language typesetting would be too difficult. After all, the layout and the images are already prepared and I only need to flow in the text - how hard could that be? I was sure that a simple Copy and Paste, or text importation, would do everything. Who is Your Customer? When you want to sell something?anything? you need to first know who is going to buy it. Why? Because your ad copy has to be written to that person. 3 Reasons why Content is Still King Back in the late nineties, the phrase 'Content is King' was repeated and repeated and repeated by site owners and marketers alike. The belief was that the more content you had, the greater the number of visitors you would attract. 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, freelance writing may be the right career for you and it can open a world of lucrative opportunities for you.You do not need to have special qualifications to be a freelance writer and make money. The Power of Saying You Can If you have children, you will doubtless remember saying to them, "You can do it."It's what we say when our toddlers first struggle to their feet. 3 Copywriting Tips - How To Edit For Mass Appeal! Web copy that's intended to sell or generate leads needs to quickly reach out and grab attention and build rapport with a target audience. You can connect with your audience more effectively if you understand something about how people process information, and how they think. Be Contagious... Spread The Word! "Melissa" invaded our computers in late 1999, then "I Love You" in 2000. A year later, the "homepage. Copywriting: Drafting Rules for Professionals As a professional contractor who wears many hats, you owe it to yourself and your clients to be as organized as possible. In a previous article, I discussed the importance of delivering an organized draft that your co-creators can easily work from. Organizing Your Data to Write Better Copy Last quarter I talked about interviewing / gathering data. So now you've got several thousand words of notes, hopefully digitally recorded. The Five Rules Of Influential Web Writing Building a professional reputation requires a campaign founded on your words: the positions you endorse, the motions you advocate, the accuracy of your vision. Writing for the Web can either establish your expert credibility or destroy it.
|
||||||||||||||||||||
| Home | Site Map Copy Right 2006 Mahavir.com |
| NISL | Herbal Acne Solutions | Promotion Factory | Web Design | Online University Degree | College & University | GtpInfo | VPayU |
