Technical Writing

I recently took on a large-scale technical writing project. There’s a huge market for this kind of writing, which makes it a good opportunity for going full-time. It’s not what most people think of when they say “I want to be a writer” — you’re not creating fictional masterpieces, or breaking a major case with investigative journalism. But you are making peoples’ lives easier while honing your writing chops.

For folks who don’t know, technical writing means documenting some kind of process. The name implies writing instructions for some kind of gadget, but it applies just as much to assembly directions for Christmas gifts, employee manuals and how-to pieces.

Successful technical writing requires a few skills that aren’t necessarily part of other kinds of writing.

Interviewing

The key process in technical writing is taking information out of somebody’s head, then putting it on paper. This means you need to be able to effectively interview that person. Active listening, leading questions and reviewing answers for completeness are all parts of this skill.

Psychology

You will have to understand how the human mind learns and takes in information. Without this basic knowledge, you won’t be able to structure and organize the instructions in a way that makes sense. You don’t have to be a psychiatrist or therapist, but you do need a basic understanding of learning and decision science.

Clarity

Clear, concise writing is the hallmark of good technical copy. You have to be able to write in a way that leaves no room for doubt or error, while also keeping the instructions accessible and interesting. This can sometimes make technical writing less fun than other kinds. There’s little room for clever prose or flights of fancy.

Detailed Fact-Checking

All writing requires fact checking. In fiction, you have to review your work to make sure of a minor character’s name, or whether a specific location has features you want to use. In non-fiction, you check the accuracy of what you’re reporting. Technical writing goes a step further, needing you to double- and triple-check the steps and flow of the process you’re documenting. This is one reason technical writers often work in teams, so they can help check one another’s work.

The bad news is not everybody comes to the table with these skills. The good news it that they’re skills everybody can learn.

Thanks for listening.

Friday Fun: Shameless Plug

Check it out! I’m a featured blogger at travel website FlipKey.com. Follow this link to read my article about travel safety with kids.

http://www.flipkey.com/blog/2011/11/11/6-safety-tips-for-traveling-abroad-with-kids/

In addition to fame, fortune and an unlimited supply of reasonably clean oxygen, this title comes with a seriously nifty badge I can put in my blog.

 

 

 

 

 

 

How cool is that?

Meeting Clients

One nice thing about being a freelance writer is you do most of your work from home. This is especially valuable for me right now, since I get to work right next to my baby son. This means flexible hours, casual day every day, and fewer work-related expenses like gas for the commute and eating out for lunch.

But sometimes you actually go out to meet a client. Personally, I like the change of pace. I get out of the house, and get to visit with people. I have to admit that the move from running a freakin’ karate school to staying home in front of a computer was kind of jarring.

A risk freelancers sometimes face is forgetting how to act in professional situations, which can mean blowing an interview or leaving a bad taste in a client’s mouth. This week was my second meeting with a new client, who seems to be happy with my work and presentation thus far. Here are some of the things I reminded myself to remember not to forget.

  • Observe basic hygiene. Shower, shave, and check yourself in a mirror. If you live alone and freelance, this can be easy to forget.
  • Dress professionally. I showed up for my first meeting in a suit. The staff was dressed casually, including the owner in t-shirt and jeans. My second meeting I came in slacks and a polo. When in doubt, overdress.
  • Shake hands with everybody you talk with. Look people in the eye. Ask them questions about themselves, especially things relevant to the assignment you’ll be working on.
  • Show up on time, and fully prepared for what you’ll be doing that day.
  • Work to the schedule you agreed on. If you said things would take 30 minutes, don’t run on for an hour.
  • Resist the temptation to shoot the breeze. Half of all business communication is small talk between colleagues, but you’re not part of that tribe yet. If you can’t resist the urge to visit, consider taking your point of contact to lunch.
  • Use professional language and demeanor at all times. No jokes. No cussing. No innuendo.

For people who work in the businesses world every day, many of these things become habits. At-home freelancers sometimes need a little reminding.

Thanks for listening.

Going Viral

Last Friday’s post was about websites that got enough traffic for the writers to turn them into book deals. It’s inspiring, as are the large sales some self-published authors are enjoying through partnerships with Amazon.com.

The situation begs the question: how do you create something that gets that many hits? A totally unscientific, random survey of podcasts, books, YouTube videos and websites with lots of traffic brings a few themes to the fore:

1. Be Funny

If you’ve ever read a funny email with a subject line beginning with “FW:FW:FW:FW:FW:FW:FW:FW:FW:FW:FW:FW:FW” you understand how much people like sharing laughs with their friends. If you can get a belly laugh, you have a better chance of getting traffic.

2. Find a Niche

Niche hobbyists like reading stuff about their interests, and share with others in their tight-knit community. You won’t sell 1,000,000 copies of your book — but you might find 100,000 people to buy every book you write. It’s like owning a restaurant in a small town. You don’t get big city traffic, but you get a lot of repeat customers.

3. Be Adorable

Pictures and videos of kittens, babies and other “warm fuzzies” get more hits than useful videos showing you skills you can use. “Cute sells” is the model behind the Hallmark Store. ICanHasCheezburger.com and similar sites pay testament to the perfect storm of combining adorable with funny.

4. Be Inspiring

This may be a subspecies of the “adorable” approach. Type-A personalities share these messages with their Type-A friends. Though there aren’t as many of these people as those who like pictures of puppies, they tend to have extra money to spend on your books.

5. Be Prurient

People are fascinated by the dirty underside of life — hence the popularity of C.O.P.S. and similar shows about criminals and criminal life. Even people who would never actually look at pornography (yes, both of them) will tune in for a show about the porn industry. If you can bring forward facts about the seamy, the violent, the criminal, the nasty…people will flock to learn about those facts.

On the other hand, the most successful writers deal with subjects they’re passionate about. If you don’t feel like writing about highly successful kittens who run drug rings for clowns with rare neurological disorders, you shouldn’t start a website just because you think it will be popular. Your boredom will be as palpable to the readers as your passion for what you would have written on.

Friday Fun: “New” Way to Get Published

Publishers have always preferred authors with a “platform” — a group of people who already know about and will buy things they write. That’s why celebrities keep getting million-dollar advances to write advice books on topics where they have no expertise.

One way to cash in on this fact is to create a platform using social media, then come to the negotiating table with a list of customers. For today’s Friday fun, I’ll point you to the web pages that started successful authors on their way.

Keep in mind that humor seems to be one of the best ways to “go viral” with social media. These sites are funny, which means some people might find them offensive. Don’t say I didn’t warn you.

Shit My Dad Says started as a Twitter feed of funny statements by Justin Halpern’s cantankerous dad. It turned into a major book deal and a TV show starring William Freakin’ Shatner.

Things My Girlfriend and I Have Argued About is an example of truth in advertising. Author Mill Millington’s reports from the domestic front. Three books later, the relationship — and the laughs — are still going strong.

27b/6 is the work of David Thorne, a designer who started publishing his more frustrating email exchanges. He makes these exchanges extra frustrating by venting his impressive hostility on the poor saps who inconvenience him. He apparently has a book deal now.

Tucker Max is not for the faint of heart, or the good of sense. The two books from his website (so far) are I Hope They Serve Beer in Hell  and Assholes Finish First. If you like drunkenness, womanizing and general bad behavior, you’ll find it funny. If you don’t, avoid clicking on the link.

How about y’all? Anybody have some similar sites to add to the list?