Technical Writer ranks No. 13 with top jobs for 2010

12
Jan
0

According to an analysis conducted by CareerCast.com, the job of Technical Writer ranks as one of the best jobs to have in 2010. For the complete list of the top 20 best and the top 20 worst jobs, see the Reuters article.

Top Jobs for 2010:

  1. Actuary
  2. Software engineer
  3. Computer systems analyst
  4. Biologist
  5. Historian
  6. Mathematician
  7. Paralegal assistant
  8. Statistician
  9. Accountant
  10. Dental hygienist
  11. Philosopher
  12. Meteorologist
  13. Technical writer
  14. Bank officer
  15. Web developer
  16. Industrial engineer

It’s rather funny to be beat out of number 11 by the job of Philosopher, but we will take what we can get. Happy tech writing to all in 2010.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and user guides. Email us for more information about our services at info@yourwritingdept.com.

Web site, web site or website? A quick poll.

25
Dec
6

Time for a quick poll. Which is your preference?

  1. Web site (W in caps)
  2. web site (w in lower)
  3. website (w in lower and one word)

Respond with your preference and explanation, and I will compile the results.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and user guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.


Quick Reference Guides are more useful than a 150-page user doc

11
Nov
4

RonBy Ron Creel

Tom Johnson’s blog, I’d Rather Be Writing, posted Minimizing Documentation not a moment too soon.Join us on Facebook

I’m working on a project to boil a 150-page software user document down to a one-page reference guide that can be tacked to a CSR’s cube wall. Our goal with the one-page reference guide is to give the CSR a description of all the navigation elements and application functionality so they can quickly navigate to where they want to go without first having to trudge through the complete 150-page user doc.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and user guides. We like to say that we can be your tech writing team, without the overhead. Email us for more information about our services at info@yourwritingdept.com.

Of course, the full doc is important for learning and supporting the overall application, but the one-page doc will serve to cut through all the error messages, screen paths and extra material.

Give users a quick reference guide

You can give users a short quick reference guide (under five pages). This gets the user up and running with the system. Quick reference guides reduce the instruction for the system to the core tasks and presents those instructions in an abbreviated, concise way. If the user needs more information, point him or her to a full database or online help file where or she can search for answers.

This all comes down to giving the end user the documentation that is most useful to them and their needs as they do their job. We may be required to write a 150-page document to support an application, but the user should have a small version of the information made available to them so they can quickly and easily do their job without digging through a lot of meaningless documentation. A short reference guide should not be overlooked when building a document set.

Additional Posts from Your Writing Dept

More InfoPorn: Our new favorite site

21
Oct
0

I’ve said it before and I’ll say it again. I love InfoPorn. This is what we consider the presentation of what could be considered dull information in interesting and fascinating presentations. Trust me, these are not your typical MS Excel bar charts.

The site Information is Beautiful seems to have it all for the infoporn addicted. Their latest, Left vs Right, explores, graphically, the differences between the left and right political parties.

Concerning their approach to presenting the information, this is what they have to say:

This kind of visual approach to mapping concepts really excites me. I like the way it coaxes me to entertain two apparently contradictory value systems at the same time. Or, in other words, I like the way it f**ks with my head.

Their other posts include:

This site is worth checking out and following regularly. I know we will.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and user guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.

Additional Posts from Your Writing Dept

Technical Writing Jobs: Salary Information

8
Oct
4

Interesting reading: United States Bureau of Labor Statistics (BLS)  Occupational Employment Statistics (OES) (free and available to the public) about how technical writers are paid. This provides some interesting reading for anyone wishing to determine where their state ranks regarding salaries or job availability. There’s a lot of information available, so explore the site and crunch the numbers as you wish.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and user guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.

Highlights

  • Number of tech writers:
    Total in US, 47,460
    Highest state: California with 6,760
    Lowest state: North Dakota with 50
  • Percentage increase/decrease in salary: Portland, OR: +16% and Chicago -6.9%
  • Median salary for all technical writers across all industries in 2008 was $61,620.Join us on Facebook
  • California ranks as the state with the highest salaries—median: $75,680, 90th percentile: $109,740; however, Peabody, MA was the Combined Statistical Area (CSA) with the highest average annual wage of $110,900.
  • States with the most technical writers are California, Texas, Massachusetts, Virginia, Michigan and Maryland.
  • States with the most positive growth in numbers of technical writers in 2008 were New Jersey and Michigan. Those that suffered the most losses were Texas, Virginia, North Carolina, Utah, Colorado, and Missouri.
  • Highest paying states include: Washington, California, New Mexico, and Massachusetts.

Additional Posts from Your Writing Dept

Where To Go To Become a Tech Writer or To Find One To Hire?

5
Oct
2

TomBy Tom Guarnera

Related posts…

Finding a single place to learn about Technical Writing is not the easiest task. Because of this, it is even trickier to find a good source for locating potential candidates for the job. Many writers seem to be just born with this ability, while others have learned it through intensive study. Meanwhile, others have gone a path in life that through training, natural abilities and fate have gravitated to this field.

There are no rules or absolutes in finding a tech writer. For example, I look for the following when hiring a candidate.Join us on Facebook

College educated, preferably in journalism. I would look for some indication of a technical background. Many times this can be found in the military, but I would want to temper the rigidness of the military with a civilian advanced education. I would strongly consider a person who worked in a technical or mechanical world, but then went to college.

I stress college, but not for the obvious reasons. Too often I feel that being “book smart” often dumbs down your abilities. That said, the path taken to earn a college degree is not usually a straight one. On top of your classes required for your major, you have to take classes such as English, speech and history. Likewise, the very task of completing the required course work is daunting and takes a commitment that not everyone posses. This long term commitment can be found in the military as well. Both paths require you to follow certain rules, but yet be flexible enough to adjust as your surroundings change.

You may have noticed that I am not entirely keen on English majors as technical writers. I have met a number of really good writers along the way that are masters of the English language. Unfortunately, many people out of your average English department have a strict zero tolerance policy in the rules of the language. In tech writing, these rules are often broken. Knowing when and why they need to be broken is helpful. Another disadvantage to the average English Lit major is that they are often taught that sheer volume of words and punctuation makes for good reading. Of course, I am over simplifying and generalizing. When you are choosing a person based on a one to two hour interview process, you have to make some generalizations. I use the analogy of a parking lot speed bump when looking at complex sentences.

Journalism majors seem to be the counter balance of the English major. In journalism, brevity is taught as a rule. The Associated Press (AP) Style Guide is taught in J-school and I have found these rules more in line with good tech writing.

If someone asked me the path to take to become a successful tech writer, I would say this (WARNING: parents preparing to send their child to college, beware!). I would tell someone, go to college; community, state, private…it doesn’t matter to me. Just get at least a four year degree, but probably in more than four years time. Change your major at least three times. Get some business classes, some computer programming skills and finally end up in the journalism department. While earning your degree, work your way through with some sort of blue collar labor. This will help you appreciate your education as well as giving you the possibility to improve your technical skills. Somewhere around your third year, drop-out when the weather starts to warm and sell everything you own. Travel Europe by rail until your money runs out. Get a job in Italy as a dishwasher and stay two more months. Come home, re-enroll, get focused and graduate way ahead of everyone else. Enter the Tech Writing world and hold on for the ride.

See the first two articles in this series by Tom:

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and how to guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.

Additional Posts from Your Writing Dept

What Are the Characteristics of a Good Technical Writer?

30
Sep
2

TomBy Tom Guarnera

Related posts…

In my previous post, I started to address the question, “How Do I Become a Technical Writer?” I concluded that most writers do not set out to go into this field, but more likely happen into it by chance or by a series of stepping stones that naturally led them down this path. I stated that through nature and nurture, people are formed to become a writer. So, what characteristics make up your average writer?Join us on Facebook

I must start by making a point. Most writers that I have met along the way are far from “average” or “normal”. I think this is due to the number one characteristic of a Tech Writer. We are all nuts! OK, maybe not certifiably crazy, but just a little nutty. Probably a better way to describe us is to say we are quirky.

Why is this the case? If you think about it, there is a good explanation. Most people in this world tend to be more technical or more creative. As we know, you can be very right-brained and still be creative, but most people tend to fall into one of the two hemispheres. In contrast, technical writing is the process of taking very technical information and processing it so a larger group of readers can understand. This involves strong writing skills, understanding the technical inputs and a creative way to display this information for the reader.

Technical writers tend to fall somewhere in the middle as far as the whole left/right brained thing goes. This is characteristic number two. We have the ability to dip into both hemispheres of the brain, thus acting as a communication bridge for those that are predominately left or right.

This second characteristic probably explains a little of the first one. Since most people fall to one side or another, we come off as a little odd to everyone else.

The next characteristic of a good technical writer is that they must be a very detail oriented person. If you walk out to the nearest street and ask people if they are detailed oriented or not, you will probably get about 95 percent of the people who will say they are detail oriented. We know that this is not true. There is a huge chasm between those who say they are detailed oriented and those who are not. Unfortunately, I do not have a litmus test for this. Anyone have any hints on detecting this skill?

The next trait you find in a tech writer is that they must be part sleuth and part jack-booted thug. Many times the information needed in order to write a document cannot be found on the surface. You may need to dig deep into the brain of your subject matter expert (SME). Sometimes this can be done by carefully wording relevant questions. Other times this is done by brute force that may border on the side of criminal. You know those people who keep their money buried in the back yard so nobody can “steal” it? Well, there are the people who treat information the same way. For some reason, many of them are drawn to computer programming. To many of these SMEs it does not matter that you are on the same team and trying to serve the same organization goal. Mastering the trait of information extraction is not always easy. One place you acquire these skills is in the world of journalism. In fact, I am partial to hiring journalism majors to become junior level tech writers. My next posting will discuss this in further detail.

Another characteristic is the ability to write. This may seem entirely obvious, but it is much deeper than it may appear. Knowing how to write well and knowing how to be a good technical writer are not the same. For example, Herman Melville, the author of books “Moby Dick” and “Typee” writes very well. He is the master of spinning the English language into a tapestry of words and paragraphs that provide the reader with a picture that many people just cannot do. That said, I wouldn’t want to use software that had a help file written by him. I am admittedly not skilled enough in the English language to teach someone how to write like a tech writer. I do know that there are those who can write this way and those that can’t.

Finally, there are two final traits to possess as a technical writer. It is my opinion that to have long term survival in this field, you must be flexible and have a life-long thirst to learn. Flexibility is important because as you move through your career, you will find that each company has their own style. Worse than that, many companies do not have a style, but expect you to follow it none-the-less. Knowing how to bend and shape yourself without being a push over is vital. Along with that, you will need to constantly keep yourself in a position to learn. By its very nature, you will need to learn new applications or systems you are writing about. You may not have to know every detail, but yet still be able to communicate those details to the reader. Likewise you will always need to learn new tools and techniques used as a writer. As the world becomes more and more technologically advanced, so do the tools and systems used in the profession. Simply knowing Microsoft Word will not cut it these days. Being even a novice user in tools such as Adobe FrameMaker and RoboHelp, will put you far and above the average writer. Add to this the changes that are happening with languages such as XML and the DITA standard, and you have exciting opportunities to learn and prove yourself to be the better candidate.

I have identified some the characteristics, trains and skills needed to be a tech writer. In my next post, I will discuss where you might go to acquire some of these learned skills and where to look if you want to hire someone who possesses them.

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and how to guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.

Additional Posts from Your Writing Dept

How Do I Become a Technical Writer?

28
Sep
4

TomBy Tom Guarnera

Related posts…

Tech Writing News…

I have recently seen a number of discussions asking technical writers if they chose to become a writer or if it was more by chance. After some side discussion with other technical writers, I started to think about the people who I have worked with and interviewed over the last 15 years. The interesting thing is that I have known very few people who one day decided to go into this profession and followed that with the question, “How do I become a Technical Writer?” In simple terms, nobody graduates from high school and says, I want to grow up and become a tech writer.

Why is that? One reason is that the field is not widely understood. This is often very evident by those who manage the people who manage tech writers. If you are experienced and work in a self-managed organization, this can be great. If you are in an autocratic org, there is nothing more painful than having upper management that have no clue as to what you do.Join us on Facebook

Another reason may be that there are very few Technical Writing programs in the college and university system. There are some English programs that, for example, offer a specialization in this field. More likely, you will find a program in a University Extension program.

So, if it is difficult to become educated in the field, where do these writers come from? Most writers that I have met through the years have landed in this job through circumstance. Of those people, the ones who excel in the field have done so through nature and nurture, but with little idea that this is the direction they are going.

In my follow-up post next week, I will ask What Are the Characteristics of A Good Technical Writer?

Your Writing Dept is a Sacramento-based writing firm that specializes in developing technical manuals and how to guides. We’re the leaders in technical communications in Northern California. Email us for more information about our services at info@yourwritingdept.com.

Additional Posts from Your Writing Dept