Re: What Are the "Cutting Edge" Technical Writing Skills?

Subject: Re: What Are the "Cutting Edge" Technical Writing Skills?
From: Bruce Byfield <bbyfield -at- axionet -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 14 Sep 2003 15:08:36 -0700


Ted Engel wrote:

What are the skills that place one at the forefront of technical writing?

Obviously, strong writing skills, a passion for learning, and a mastery of software programs such as Microsoft Word, Adobe Framemaker and Acrobat, and RoboHelp provides a strong foundation, but what are the skills beyond these that truly make a writer marketable?

Is it XML? XSLT? Flash? Adobe InDesign? VisualBasic? Indexing? Web usability? These are obviously just a small number of what are many possibilities, but I'd like to know what you think are the most valuable skills for a writer looking to move ahead of the curve, both today and in the coming two to three years.

I would discount all your suggestions. Technical writing requires some writing skills, but is not nearly demanding as journalism, let alone fiction. Similarly, a passion for learning is important if you're a contract technical writer, but, if you're in a full-time position, I suspect that the ability to tolerate routine is more important. As for software skills, they may satisfy the HR Department, but they can be learned quickly, and don't make an outstanding writer. Not that these skills don't matter, but they're secondary.

In my experience, the two most important abilities for success are knowledge of your subject matter and organization. Naturally, you can't always know your subject matter coming in to a job, but, the faster you master it, the better you'll be at anticipating what your audience needs to know and do. Organization matters because it is relatively rare. Many people can learn to write a clever or concise sentence, or even a paragraph, but organization beyond these levels is rare, even at university. It's closely related to subject expertise, because, unless you know what you're trying to organize, you can't find a suitable organization - the best you can do is try to squeeze information into a template you've gotten from somewhere else, and hope that it's vaguely appropriate.

However, if you're a consultant, then I'd say that even these abilities take second place to a knowledge of how to conduct business: how to make connnections, and how to conduct yourself professionally. Without these skills, you'll never even get a chance to show what you can do with actual writing.

--
Bruce Byfield bbyfield -at- axionet -dot- com 604.421.7177
http://members.axion.net/~bbyfield

"Some are here working on a passage to heaven
And others they can't carry that load
A few are left singing the blues on Purgatory Road"
- Ray Wylie Hubbard, "Purgatory Road"



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?
?Mustang? (code name) is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to Web, intranets, and online Help.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! See a live demo that
will take your breath away: http://www.ehelp.com/techwr-l3

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
What Are the "Cutting Edge" Technical Writing Skills?: From: Ted Engel

Previous by Author: Wanted: experiences integrating OpenOffice.org with web apps and business processes
Next by Author: Re: Marketing Yourself
Previous by Thread: Re: What Are the "Cutting Edge" Technical Writing Skills?
Next by Thread: Re: What Are the "Cutting Edge" Technical Writing Skills?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads