Calling all Technical Writers/Editors!

I’m taking a Business Ethics and Practices course (BUS 201) through the University of St. Thomas (in St. Paul, MN); one of our assignments concerns career development. The first step in the assignment was to take some career assessments and skill inventories. The second step was to select a career field about which I want to learn more. I selected Technical Writer/Editor. Step three was to arrange for two informational interviews in the selected field. I have already arranged for the interviews, but would be very interested in Doper answers to the following questions about the field:

  1. What advice do you have for me in beginning my preparation for this career?

  2. What qualifications would you consider “must haves” for this career?

  3. What was your career path?

  4. What ethical issues have you encountered in your profession or position?

How was the dilemma resolved?

  1. What are the upcoming issues in the field of technical writing/editing?

  2. What do you enjoy about being a technical writer/editor?

  3. What do you dislike about being a technical writer/editor?

Thank you in advance for your help, my Dopey friends!

Mod, I’m looking for this to become a mundane and pointlessconversation about technical writing/editing, but if you feel that this should be in General Questions, I will not fight you. I will curse your name, but I will not fight you. :smiley:

[QUOTE]
*Originally posted by Gazelle from Hell *
**

  1. What advice do you have for me in beginning my preparation for this career?**
    I sort of tripped into this career, so I’m not sure I have an answer here. I would guess spend some time talking to tech writers and get a feel for what the field is about, and research the different varieties of tech writing.**

  2. What qualifications would you consider “must haves” for this career?**
    >Interviewing & communication skills are rather obvious.
    >Proficiency with various software can be important to prospective employers.
    >Science or technical knowledge, eg electronics, programming, chemistry, etc.
    >Good “people skills.”
    >Basic english skills (grammar, spelling, sentence structure, etc)
    **

  3. What was your career path?**
    Rock star or movie producer.**

  4. What ethical issues have you encountered in your profession or position?**
    Not much. Once I found a problem with some software. I reported the bug, but was asked to incorrectly describe the operation of the function, under the assumption that, A) the customer would probably never discover it, & B) it would be fixed at a later date when time and budget allowed.
    **
    How was the dilemma resolved?**
    I did what they wanted. Nobody would be hurt, and they did fix it later. It’s their product, and if they want to take the chance of misrepresenting it, they will suffer. My name is not listed anywhere as the author.
    **

  5. What are the upcoming issues in the field of technical writing/editing?**
    Technical writing is probably the most fascinating, fast moving career that an adventurous person could embark on !:rolleyes:
    Seriously, I don’t really know of any upcoming issues. I’m not the most informed writer out there.
    **

  6. What do you enjoy about being a technical writer/editor?**
    All the sex!:eek:
    >I’ve never worked for places that had a ton of tech writers (like maybe a defense contractor), so I’ve always been treated as sort of a specialist with quite a bit of autonomy.
    >If you own a certain document, you get a certain satisfaction out of watching it grow up, then be released.
    >The money’s okay, you’re not lifting heavy things, and you can listen to music while you work.
    >Occassionally you run into situations where you can work at home.
    >You get to write for a living. They’re not novels, but you’re still getting paid to play with words

**
7. What do you dislike about being a technical writer/editor?**
>It can be boring. Sometimes the topics are dull, very often the people are dull. I don’t fit in the mold of your stereotypical Dilbert type, so it can be bothersome at times.
>Your work will not be appreciated. You have to separate yourself from your product. Often you will put a lot of work into a document, only to find out it is no longer needed/outdated/unnecessary. You have to remind yourself that you did not waste your time, you are still getting a paycheck.
>For some reason, many people will never understand what exactly you do for a living.

**Thank you in advance for your help, my Dopey friends!

** I hope this helps. Good luck on your exciting journey into the world of Technical Writing.
Please do not point out my spelling and grammar mistakes.

lostbaby, when I read this, I imagined you saying it just like Ben Stein would.

Thanks for your answers. May I quote you in my paper?

I’m a little torn about this. I am not an actual, bona fide technical editor, but I do need to know a bit about the subject at hand in order to edit the paper. I edit technical papers, so I guess in theory I is one. :slight_smile:

  1. What advice do you have for me in beginning my preparation for this career?

Technical editors have an expertise in something, whether it’s computers, intelligence analysis, biology, or economics. This means that when they edit a manuscript or paper or article, they are editing not only for form and punctuation but also for content. If you worked for the Department of Energy, for example, you better be well versed in energy. So the first thing to do when preparing for the field is to have an area of expertise.

  1. What qualifications would you consider “must haves” for this career?

Most technical editors have a background in English or Communications - it’s considered a journalistic field. But as I stated with 1 above, one should also have a background in whatever one wishes to edit.

  1. What was your career path?

Edited the paper in college, then edited a quarterly compendium of abstracts of technical articles, then moved on to the real scientific stuff. :slight_smile:

  1. What ethical issues have you encountered in your profession or position?

Peer review. With scholarly journals, each article is reviewed (depending on the publication) by two or more peers of the author(s). This is supposed to ensure an objective opinion, as it’s done secretly (that is, authors don’t know who’s reviewing). But I suspect this isn’t always true, and sometimes the issue comes up whether an author knows who has reviewed his work.

  1. What are the upcoming issues in the field of technical writing/editing?

From the nontechnical standpoint, it’s an issue of streamlining the entire production process. This is something that’ll vary from publisher to publisher, from publication to publication. The bigger challenge is staying on top of the technical aspects of the content, which isn’t always easy when you’re not an actual scientist.

  1. What do you enjoy about being a technical writer/editor?

I can edit as always, but I’m also editing papers written by Nobel laureates and other prominent scientists.
7. What do you dislike about being a technical writer/editor?

It can get tedious, as can any editing, really (except maybe for MAD magazine or Rolling Stone).

That’s a pretty good guess. I was thinking of it in more of a Troy McLure voice.

Quote away.

1. What advice do you have for me in beginning my preparation for this career?
Take some technical courses (computer programming, engineering, chemistry, biology) along with your writing courses.
Read some journals (Communicator, say).
Talk to Tech Writers (or Technical Communicators, as the field is starting to be called - includes technical editors, illustrators, and so forth).
Never ever say, ‘I can do this, writing isn’t that hard - ANYONE can write.’

2. What qualifications would you consider “must haves” for this career?
Good grammar and a love of writing.
A willingness to put yourself in someone else’s shoes (be an advocate for your reader).
A fundamental urge to be helpful or to teach. Good technical writing helps people, or teaches.
A good comprehension of some kind of science or technology is helpful. Doesn’t have to be a particular field, but there are amazing overlaps.

3. What was your career path?
Geoghrapher (international business geography). That has rolled sideways into technical writing, and I’ve just come full circle by moving into Internationalization as a specialty, applying my cultural geography master’s degree to my writing career. FINALLY!

4. What ethical issues have you encountered in your profession or position?
Conflicts between meeting the deadline and meeting the needs of the users, mostly. Sometimes conflicts between doing what I’m paid vs. doing what the client wants (but hasn’t agreed to pay for). And the eternal ‘should I write something that is cr*p just because the client likes it that way, or should I fight to produce better product despite what the client wants?’

And my current favorite: Is it really cultural imperialism to write documentation ‘for translation’ - does it assume that people from other cultures cannot figure out the differences in what I wrote (before it has been translated), or am I, by modifying my language use ‘for translation’, really saying that I am better than they - that I can see clearly into their culture, and they cannot see clearly into mine. (this one does not actually come up as a working question, but a philosophical discussion - the client gets what they ask for, period, and if that means Internationalizing the content, I don’t ask if there are any post-modernist cultural anthropologists in the user base.)

How was the dilemma resolved?
Almost always, the client wins. And usually, the deadline wins. Though when I’m doing a really good job, I work out a compromise - results that aren’t complete cr*p, and that serve the users needs well, even if not my ideal, on time, on budget.

5. What are the upcoming issues in the field of technical writing/editing?
-Whether to move over to all HTML help, and dump Winhelp entirely.
-Internationalization (see above ethics issue) and writing for translation. Many multinational clients out there want both their software and their documents localized, which means internationalizing them first.
Lots of other issues, about involvement in the design process for user interfaces, usability testing of documentation, and so forth.
6. What do you enjoy about being a technical writer/editor?
Teaching, writing, helping, figuring out what the users need and getting it for them. Having the users say, ‘I don’t even need training, the user guide answered all my questions.’ :smiley:

Working with teams that appreciate what I do, with clients that ask for me again, and with project managers who budget appropriate time for my work. Being part of a good team is very satisfying. Being able to put out a quality product is great.

7. What do you dislike about being a technical writer/editor?
Working with people who think I’m an input device - give me a functional spec, and I type, and that’s all there is to creating training manuals or online help. No thinking involved. No analysis, no figuring out how best to present the materials to suit the user’s needs. No budget for doing so, either time or money. No knowledge required - anyone can write, for pity’s sake. You’ve got 5 days to turn this out-of-date 150 page functional spec into an accurate 16-chapter user guide. With appendices and a comprehensive index.

Or with people who think I have some kind of technical psychic foreknowledge. We ran out of time in development, so you have to start writing the manuals for a system that doesn’t function yet - and the FRS hasn’t been updated, BTW. Or, the client keeps changing the spec, but you need to start writing now if you want to get the user guide done in time for installation (nothing like hitting a moving target!).

Or with people who think I’m completely new to the whole magical world of technology… the ‘wow, you actually understood my technical information’ response. After editing a white paper, the author said, ‘wow, you fixed that up so well, it’s like you even understood the technical stuff!’ Um, that’s because, I’m, like, you know, a technical writer… :smack: Boy, where do you even go with that one? (I replied calmly that I understood the info because I’d actually TAKEN a Unix Admin course, thank you very much.)

Fortunately, the vast majority of my experience has been with teams who value me and my skills, wish they could give me more time than was budgeted, are helpful and informative, and appreciate my input.

Preview! - that was supposed to be a preview! (Spellcheck is my friend… “Geographer”)

A thick skin for being edited also helps… never take edits personally.

Wow, you guys rock.

Thanks dantheman and hedra; way to share! May I quote both of you in my paper?

Now that’s a quote I’d like to see. Don’t think I’ve seen “dantheman” in a paper before… :wink:

Nope, I don’t mind.

that you’d use the info was assumed - but formal permission is granted. :slight_smile:

I thought it was pretty much implied in the OP, but figured I should ask…

Muchas gracias, hedra.

Another tech writer here, high-tech industry.

I think everyone answered the OP’s questions well.

I not only do writing, but technical illustration, so experience with vector drawing apps (Illustrator, CorelDRAW) can be an asset.

My background is in music, but I did a lot of freelance translation in school and afterward, so that kind of applies to tech writing.

My first job after university was as a graphic designer, and not did only my design/illustrration skills improve exponentially, but I realized learning new applications was a breeze for me. We use FrameMaker here at work, and one of my assignments last winter was to master Frame inside-out, re-design our styles, and prepare a style guide for our translators.

I like that I’ve learned how to break down rather complex software & hardware installation information into easy-to-follow steps.

I love it when we get our first copies of a manual we’ve worked months on when they come off the presses.

I hate the boredom. Right now we’re between releases, and I’m the only one in the group who’s busy, with an upcoming release for Mac OS X (I write all the Mac manuals).

It’s frustrating when they make last-minute changes to the UI and we have to re-do all of our screen grabs.

It’s frustrating that I’m still waiting for a stable build of the new Mac software. I’ve done just about all the preliminary work I can; now I need the software so I can validate, test, etc.

I like the laid-back work environment. I can wear whatever I want as long as I’m dressed, and my hours are flexible.

I like getting to play with the latest and greatest in video editing card technology.

Anyway, that’s my story.

Everyone has done a fine job of answering, so I figure I can dispense with being entirely useful and fall back to my usual cynical self.

  1. What advice do you have for me in beginning my preparation for this career?

Have your ego removed. That way the first time an editor disects your hard work like she’s cutting up a live frog, you’ll get through it without whimpering.

  1. What qualifications would you consider “must haves” for this career?

Be able to write. That’s the most important. A tech writer’s job is really that of a translator. Most programmers and engineers cannot write. Simple things like writing clear concise sentences with all of them nifty things like verbs, grammar, and punctuation really go a long way.

The second part of the equation is to be able to understand technology. Take a few programming / engineering courses. You don’t have to be an engineer, but make sure you can talk to one without your head exploding.

It also helps to have the ability not to roll your eyes back into your head whenever someone says something really stupid, but I know several writers that lack this ability and get away with it.

  1. What was your career path?

Political Science to International Relations to no job to Computer Programming to Hey! You can write! job.

  1. What ethical issues have you encountered in your profession or position?

If you ever become a contractor, accept the fact that you are really a mercenary and realize that there are fellow mercenaries who are willing to sack parts of the local town if it means getting the contract.

How was the dilemma resolved?

You’ll contract will end before it ever gets resolved.

  1. What are the upcoming issues in the field of technical writing/editing?

Why do we need this paper stuff anyway?

  1. What do you enjoy about being a technical writer/editor?

Well, in my job I document software that analyzes finite element stress modeling. In other words, It squishes 3d objects in the computer. I like to squish things.

  1. What do you dislike about being a technical writer/editor?

Anything that is cool technical invariably as a component to it that as dull and tedious technical. One day you’ll find yourself inventing a background plot to explain why the xyz component is incompatible with the current build of zyx. It will probably involve a love triangle. Be sure to hide that version from your editor.

You guys have brought up some excellent points. I’ve come up with a few other questions.

I’ve Googled… it doesn’t seem that there is a technical writing degree. Do you all have degrees? In which fields?

Also, what kind of companies do you all work for?

Some schools do offer technical writing or technical communication degrees.

I have an Associate’s in electronics, and a Bachelor’s in English/Communication. Put the two together and viola’, instant tech writer.

My last position was with a company that made analysis equipment for automotive manufacturers, and I currently work for a company that builds power generators. The previous position dealt more with the software, and the current position is mostly hardware.

I have an English degree; it took me eight years of slacking off to achieve it, so I’m quite proud.

The only worrisome part of this field is the choosing of a “specialty.” Isn’t it possible that I could choose one, study it, and graduate to find that there is zero demand for technical writers in that area?

That scares me a little.

Sure, but that’s true of any job field. It’s a risk you need to be prepared to take.

What you could do is visit a tech job-placement site, like Dice.com, and see how many openings currently exist for that particular specialty. However, my guess is you’ll just see a lot of “Technical Editor” descriptions, rather than “Technical Editor in So and So Specialty.”

Plus, many places like that you have a technical background in something, but not necessarily their thing. If you’ve ever tried to show someone how to use a computer or program a VCR, you realize that some people are incapable of learning simple technical concepts. Showing that you understand at least one technical discipline tells the employer you are capable of comprehending technical concepts.

Former BS English checking in - excellent responses all.

Here’s mine:
1. What advice do you have for me in beginning my preparation for this career?
Don’t shirk on the technical part. You don’t need to be a computer programmer or physicist, but you do need to be able to understand technical information and relay that information to others. It helps if you’ve had at least one programming class (mine was a very basic C++ class). You can pick up the other techie information you need through books when you land the job.

It seems to be a perception that too many tech writers out there want to simply take information already typed by their subject matter experts (SMEs) and merely reformat it into a pretty manual. This is not a good thing - you need to research the information yourself, then go to the SME with questions you have. It’s okay to go to them with beginner/newbie/stupid questions, but you do need to have “laid the groundwork” yourself, so to speak. The SMEs I’ve worked with have been more than willing to speak with me at length and have been very patient with my questions (no matter how dumb), but they did require me to have a basic level of knowledge first.

2. What qualifications would you consider “must haves” for this career?
Some technical knowledge, no matter what it is. Mine’s a C++ class, a year of Calculus and Physics, and two+ years of Chemistry. Just having this sort of knowlege proves to me that I can understand other complex things, like how transaction information is parsed to other tables in a database. I use this knowledge to prove to others that I can understand the systems they create and gain respect.

Second, an ability to communicate clearly, to translate the technical information you already know into a document that a member of your audience can read and understand easily.

3. What was your career path?
I started a tech writer, but my path in college was strange. Went from an English major to a Chemical Engineering major (loved the science, hated the engineering) back to an English major. My heads up advisor noted the transition and said “Hey - the Engineering Dept. offers a tech writing minor you’d be good for.” Got my first job from a professor who said, “You’re the English major, right? There’s a software company looking for some help.” It’s all been good from there, four years later.

**4. What ethical issues have you encountered in your profession or position? How was the dilemma resolved? **
Not many, really. There was the CEO who wanted information in the manuals/help files that the product didn’t really do, which I resisted. I ended up having to go to the “Break it guy” who had all the knowledge, who discussed it with the CEO, which caused a product redesign.

5. What are the upcoming issues in the field of technical writing/editing?
Hoo ha, it depends on who you talk to. There are some who will talk technologies used to create documentation, there are some who’ll talk the new technologies people are using (handhelds, phones, web, etc) and what they mean for our field, there are others who’ll say it’s a dearth of truly “technical” technical writers and what that means for the field.

There’s other issues: the dismal job market has left a bunch out of jobs, so there’s the issue of how to compete among others (some very highly skilled writers); in the software world, the reality of outsourcing has created the issue of whether documentation produced off-shore is equal to what a company can get (at a higher price) from local writers; the perception of technical writers in the industry as secretaries or “font fondlers” raises the issue of how to gain respect in your company and how to make the higher-ups recognize the value you add.

6. What do you enjoy about being a technical writer/editor?
Learning more about technological stuff. My previous job introduced me to Perl, which I mean to learn more about (but it’s been tough as I often don’t want to spend more time at the computer at home after I’ve been in front of it for 8 hours at work). I also intend to learn more about a programming language, working through one of those “…in 24 hours/days” whatever books for either Java or C.

Being able to connect the dots, to realize that this new job isn’t that much different from the old job - "Hey, it’s a database driven application with a front-end GUI, which means there’ll be triggers and flags that determine how information gets processed.

Being in on the development process, after having gained a good knowledge of the system. At my last job, I got to sit in on development meetings and was able to explain the programmer speak to the business users. It was an excellent experience, one I’d kill to get back to.

It’s also great to be able to talk with the programmers about things, drawing parallels from previous experience, that they think someone so young (and female!) might not know about. You can see a sort of surprise in their eyes.

I really enjoy the challenge of writing a document to explain something technical and complex to my audience. It’s awesome to get the doc back from review and hear people say “you put that so clearly it was so easy to understand.”

7. What do you dislike about being a technical writer/editor?
Currently, it’s the reformatting. At my current position, we need to update manuals. Fine. However, often this “updating” is no more than eliminating tables or making text Arial Bold. It’s frustrating because I don’t feel like I’m earning my pay, extending my knowledge, or really writing. However, we’ve got an opportunity coming up that will be more challenging, and I look forward to it.
Ginger, you mentioned you were in St. Paul. Look me up if you’d like - I’m in Robbinsdale and work in Shakopee. I believe my email’s in the profile.
Snicks