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, even for those in an online school taking courses. 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

Business Cards: Marketing tools with a huge ROI

13
Aug
1

Hand out your business card the way you would hand out candy on Halloween. Or at least that is what I have been told. Makes sense if you want people to know what your business does and if you want them to contact you. I think it’s good advice. Business cards are inexpensive marketing tools that can have a huge return on investment if you consider they cost a few cents each to produce and could bring you tens of thousands of dollars in business if they end up in the right hands. So hand them out freely.Your Writing Dept

Business Card Etiquette

As with everything in life–there’s a right way and a wrong way to go things. Are there certain ways to hand your business card out that are better than others? Yes, of course. If you are handing your card out to several people around a table, don’t just slide it across the table at them. That’s impersonal and does not give you a chance to connect personally with the person. Rather, make an effort to hand it to them, make eye contact and shake their hand.

Keep your cards in a case and keep them in good shape. No one is comfortable receiving a smudged or tattered card. It does not represent you well.

When receiving someone’s card. Treat it with respect. People are often proud of their cards and treating the card with respect is an extension of treating the actual person with respect.

Other countries have customs relating to handing out business cards. When I traveled through Brazil, the custom was to turn down an upper corner of the card slightly to indicate that the card was handed out in person. And in Japan, cards are received with two hands and are exchanged with great ceremony. It’s the little touches that make handing out cards that set you apart.

Designing and printing your cards

Online vendors such as VistaPrint give you options of creating your own designs or using hundreds templates available on their site. Their prices are pretty good as well. Local print shops can also include the design work into the price of printing and may be able to produce that one-of-a-kind card that will get you noticed. So shop around.

Inspiration for amazing designs

If you need inspiration when developing your card designs, take a look through these sites:

So there is no excuse for not developing attention-getting card designs and handing them out to everyone you meet.

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

A Strong First Sentence Improves Your Writing

29
Jul
1

Creating a powerful first sentence grabs your audience and sets the tone of your article. In the world of journalism, the first sentence in a story is call the “lead” and helps hook the reader. There isn’t a reporter out there that hasn’t suffer the wrath of an editor who has chewed them out for “burying the lead.” Meaning: Holding key information until later in the story.Join us on Facebook

Because of the importance of the lead sentence, you should pay particular attention to how it’s constructed for emails, news articles, technical instructions and essays.

General rules for creating a strong first sentence:

1) Keep it between 15 to 25 words.

2) Avoid starting with cliches or filler words such as “There are…” And make every word meaningful.

3) Try to state the who, when, where, how, and why so the reader can get at least something out of the first sentence if they decide to read no further than the lead. But resist giving too much information that bogs down the lead.

4) Avoid starting with a question. This is a cheap, amateur device that doesn’t work and insults the reader.

5) Edit, edit, edit. And then edit some more.

After you have written the first sentence and moved on to the rest of the story, consider circling back to the first sentence to see if it matched where you have taken the rest of the story.

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

Will Bing become the new Google? [Revised]

10
Jun
1

As search engines go, Google has pretty much set the standards over the years. I remember first using Web Crawler, and then moving to Altavista, and then Yahoo!, until Google came along. So I am not set on one search engine over another. I just want the best that a search engine can offer me.

View Your Writing Dept

I want it all is one location. I want to search for video and images on the same site I’m using for web searches. So is Bing going to bring it all together? From what I can tell after using Bing for less than a day, it looks as though it might just provide everything I need. But, I ask, is it really going to help me make decisions? I really think I can do that on my own, thank you. I just need a powerful search engine.

I plan to add to this post after I have more time with Bing and learn more about its power, or its hype.

Let me know what you think.

June 15, 2009 Update
Now that I have had a chance to use Bing for several days after the initial post, I wanted to give some feedback and further compare Bing with Google. I greatly question Microsoft’s sales pitch that Bing is not a search engine, but a Decision Engine. Say what? I’m thinking that it’s more of a “we direct you to where we want you to go engine.” Read that as, you will most likely go where Microsoft is getting its money.

Welcome pagebing
First, Google’s welcome page is simple and predictable. Bing, however, presents a new photo background on its default Explore page each day and provides links to more information that relates to the photo of the day. Frankly, I like the simplicity that Google offers. When it comes to a search engine. I want to search and not be presented with a random experience.

Setting Preferences
One of the first things you will want to do from the default page is to change your preferences from the Extras drop down menu. On the preferences page, you can change:

  • SafeSearch settings: sexual content controls go from Strict, Moderate to Off
  • Location
  • Display language
  • Number of results per page
  • Search suggestions: on or off
  • Search language

Photo search
This page opens with images relating to the default page’s photo and topic of the day. This is annoying. However, running your cursor over the image after your search for a topic will cause the image to enlarge and present more detailed information about the image, including file name, web site location, dimension and byte size.

Bing does conveniently allow for specializing and fine tuning your image searches with selection from a left-hand menu:

  • Size: small, medium, large or wallpaper
  • Layout: square, wide or tall
  • Color: color or black & white
  • Style: all, photograph or illustration
  • People: all, just faces, head & shoulders or other

Video search
With Bing, you get the feeling you are being force-feed TV shows and movies from Hula. But then again, searching for video clips is where Bing shines the most. It does present the offerings nicely and it is easy enough to search for video clips of your own choosing. One of the nicest features I’ve seen to date on Bing is the ability to run your cursor over the image of the video and run the clip directly on the search screen before opening it. This is convenient when you want to zip through video clips without needing to open them all.

Bing does conveniently allow for zeroing in on specific genre with selections on the left-hand site of the screen.

What is this Decision Engine they talk about?
The Decision Engine seems to be related to the shopping area of Bing. From what I can tell, it’s a way to do comparison shopping for things such as airline tickets. Sure, this is nice. But it doesn’t make Bing anything more than an over-hyped search engine.

Bottom line: Bing is a search engine with bells, whistles and a load of baggage I can live without. I’ll post more.

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

Filed under: Just for fun, Tips

Tips for hiring an outsourced technical writing team to document your product or process

30
Mar
0

Consider the following factors before selecting an outsourced technical writing team to develop and/or maintain your technical or product documentation. Carefully selecting the right team of writers can make a difference in the success of a product launch as well as influence whether or not your product is successful in the marketplace. Keep in mind that technical writing teams are not one-size-fits-all organizations, so it’s up to you to take the time to find the right fit for your needs and organization.

Return to Your Writing Dept

Define why you need documentation
You first need to clearly establish why you need documentation for your product or procedure. Is it new documentation to support a newly developed product or do you need to improve existing documentation to further assist in customer support? Fully determine why you need to engage a technical documentation service provider before starting a writing project.

Engage the writing team early in the process
Many technical writers are all too familiar with being brought in late in the game of product development only to join in on the mad dash to the product delivery launch date. Bringing the writing team in early allows for better documentation and a better customer experience.

Establish your budget
Set realistic limits as to what you are going to spend on your documentation project, but understand that the final user guide is designed to support your product and if it falls short of your customer’s expectations, your product may not be well-received. So plan early for your documentation requirements and factor your ROI in the cost of the documentation. Planning to go on the cheap will usually get you into trouble. In budgeting, you need to consider if you want to build document templates and style guides as a part of the project. An experienced writing team will build in time for documentation review cycles. Generally, when scoping a writing project, a technical documentation outsourcing team will look at the estimated number of pages and calculate the time to complete the project, so it is important to represent your project as accurately as you can. Neither party wants to be surprised by price over runs because a project was scoped inaccurately.

Assign the internal support resources to the project
Writers from the outside your organization may be good writers, but they may not know your product the way you do, so set aside the time for your subject matter experts to participate in the documentation development process in an advisory role. Clearly define roles and responsibilities and get buy in from the subject matter experts.

Establish if you need a local writing resource
Consider if it is important to the success of the project to have a writer is on-site. Determine if the writer will need to have face-to-face meetings with your subject matter experts, or can they be on the other site of the country? For documenting some products and processes, location is not important.

Decide if you will require project management services
Determine if you want a formalized project management process or if the project does not warrant close supervision to keep the project on track. When developing a complex or large document suite, a project manager can help keep the project on track and free up the writer’s time for the actual writing. Although project management is an extra cost, it can keep the project moving in the right direction and keep it within budgetary restraints. Keep in mind that adding project management time into the estimate will generally include several hours per week to accommodate the project manager’s time above the technical writing efforts.

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.

Additional Posts from Your Writing Dept

Advertise yourself: the job search

26
Dec
1

Advertising yourself may fall under the category of shameless self promotion, but when you are looking for a job, this may be what sets you apart from other job hunters. You need to let people know about you and your skills in a way that sets yourself apart from the competition. People are not going to know about you if you do not get yourself in front of them. Always have resumes and business cards ready to pass out.

Don’t overlook social networking sites such as LinkedIn, Twitter and FaceBook. All these sites, if used correctly, can bring the right attention to your talents and availability.

Have an online version of your resume ready for emailing to someone if they ask for it. If possible, keep a PDF version of your current resume on your PDA phone for quick emailing. People asking for a resume to be emailed to them generally want it at the time of asking, so be ready. Depending on your industry, you may want to develop your own web site to present your resume.

Be creative and use a variety of tools for getting your name and story out to people who might be willing to either hire you, or get you in front of someone who might help you promote your job search.

From Ron’s, “The Most Important Things to do While Looking for a Job”

Add to Technorati Favorites