Friday, April 17, 2015

No quirks in owners manuals


My first car was a VW Squareback, with a very Zen stick shift. The shifter knob outlined four forward gears and reverse. The owners manual included a similar illustration, with additional tips that never mirrored reality.

There was no telling where second or third gear would be found on any given shift. The only way to drive this car was to get a feel for the general vicinity of each gear and then be playful.

My smartphone has similar quirks not found in the manual. It would have been helpful to read something like: “Place the phone down gently, or it will spontaneously reboot. If this is a problem, jam a piece of cardboard next to the battery to ensure a secure fit.” The troubleshooting section could be one sentence: “When something stops working, turn the phone off and on again.”

When my vacuum cleaner started to misbehave, I searched the online manual for instructions. I found the illustration for disassembling the lower plate to get to the beater brush, which the manual calls the “agitator.” What was more agitating than this brush was the sparse drawing overlaid with arrows in all directions. The few words of description were useless, and only after significant yanking and cursing did I find the tiny locking tabs that were the secret to success.

Other clues I wish were provided in owners manuals:
  • To reset the low-tire-pressure gauge in my car, press the well-hidden button in the glove box.
  • To restart my mother’s cable box after a service outage, hold the power button for five seconds.
  • To restore service to my Internet radio, unplug and replug the power cord.
Simple solutions? Definitely. What made them difficult was finding the answers, which sometimes came from online chats, from calls to service departments, or trial-and-error approach.

I don’t envy technical writers who work on owners manuals. They don’t know much about their audience or how much their audience knows about their product. They don’t know which details to include or how detailed to make their answers.

One thing technical writers do know, and practice quite well, is to appease company lawyers and make sure any potential liability is clearly identified. Take this sentence from my car manual: “If you are in a collision in which airbags deploy, wash your hands and face with mild soap and water before eating.” Personally, I’ll go to the hospital first; I think my appetite would be ruined by the crash.

As much as I love to hate owners manuals, I like having one for reference. They may not tell me what I really need to know, and often offer too much unnecessary information, but you never know when they just might come in handy.

Tuesday, April 7, 2015

Now everyone is doing it

The Internet is like high school. Someone shows up with something shiny and new; pretty soon everyone wants or has the same thing.

Website design is showing just as much trend envy.

Splash pages used to be the big thing. Then flash animations. Now it’s the BIG PICTURE.

More and more websites spread a single photograph or graphic across the top half of the screen. There might be a few words, maybe a title and subhead in a large font. To find out more, you have to scroll down. Even then content is sparse, because, you know, people don’t like to read anymore.

Note to big-picture Web designers: Your pages are pretty. Your pages don’t tell me what I want to know. Ironically, the big picture approach doesn’t give me the big picture on content. A photograph isn’t always worth 1,000 words. Sometimes a photograph is just a photograph.

Granted, I’m a word person. Writing is what I do. Depending on the medium and the message, I tailor my approach for more or less content. Either way, content is key.

Words matter. People do like to read if it’s content they’re interested in, that engages them, that tells them what they need or want to know.

The first few big-picture websites I saw were intriguing in their novelty. And they were visually attractive, with beautifully done, professional photographs.

Now that more people are borrowing this design approach, using similar templates, the cracks are showing. The photos aren’t always so great; maybe they’re low-res or straight from a phone app. The content is sketchy. There’s no “there” there.

If I were just surfing the Internet for fun, these sites would be eye candy (at least the good ones would). But my surfing days are over; I click to find answers, information, content.

The good news is everything on the Internet seems to be a trend. I just can’t wait until the next one comes along.