The Value of Adding Images to Technical Documentation

It's clich?, but true-a picture does paint a thousand words. This is an important message to remember when writing any sort of user documentation, such as an installation guide or an instruction manual. A document that makes judicious use of images and diagrams will be much easier to understand than one that is composed entirely of text descriptions.

I observed this first-hand years ago, when a junior programmer at one company was asked to update the software installation manual for their machine controllers. One of the first things he did was to strip away all the screen capture images, reducing the entire document to plain text. "These images are just silly!" he said. "They take up space, and they're just not necessary. I trust that anyone who reads this document will be smart enough to figure it out."

This turned out to be a huge mistake. The technicians who had to use the manual had a difficult time making sense of its instructions. They had to repeatedly ask for clarification, and one of them told me that the pure text descriptions were just too cumbersome to follow. They were fearful of using these instructions at all, knowing that a single misstep could lock the controllers into an irrecoverable state. It was a ugly situation all around.

The problem was that this programmer didn't try to make things easy for the users. For one thing, he failed to consider that some technicians were not native English speakers, and that they might struggle with the wording. More importantly though, this programmer expected too much from his audience. He wanted to reduce these instructions to their bare essentials, thinking that would be adequate. He failed to consider that even an intelligent, otherwise careful reader might be tempted to jump over instructions, or would gloss over some critical detail. This is a common pitfall when time is short, and when the users are confronted with pages and pages of bland text.

A few carefully chosen images, with suitable captions, can go a long way toward preventing that. When I saw that the junior programmer was stripping away all the screen capture images, I cautioned him against that. "These images may not be strictly necessary," I said, "but they help clarify a lot of details. For one thing, they show the user exactly which button to push, or which window to select. This makes the instructions much easier to understand, and reduces the likelihood of a human error." To this day, I wish that he had heeded my warning.

Were the users intelligent enough to understand the manual, as he claimed? Certainly-but intelligence is no guarantee against human error. Could the images have been construed as talking down to the user? Perhaps-but in my experience, sophisticated users seldom respond that way. Rather, most of them seem to understand the value that these images bring to the table. Perhaps it's because most of them know what it's like to be frazzled and pressed for time, and how easily important details can be lost in the text.

So remember-a picture paints a thousand words, and a single screen capture can be worth more than a dozen pages of text. It's a lesson that's worth learning.

V. Berba Velasco has a doctorate in Electrical Engineering and has been practicing his trade for nearly a decade. During that time, he has repeatedly found that good technical writing skills are almost as critical as good engineering skills. Dr. Velasco currently works as a senior electrical and software engineer for Cellular Technology Limited (http://www.immunospot.com), a biotech company in Cleveland, Ohio.

cheap limo service Lombard .. Lockport Chicago limo O’Hare
In The News:

Recent reports show many common passwords can be cracked in literally seconds. Kurt the CyberGuy explains how to strengthen your passwords.
Stay up to date on the latest AI technology advancements and learn about the challenges and opportunities AI presents now and for the future.
Iron, a robot that stands 5 feet, 8 inches tall and weighs 154 pounds, combines advanced artificial intelligence with human-like movement and exceptional vision.
Hertz, the rental car giant, recently confirmed that customer information was exposed through a cyberattack on one of its software vendors.
There are a number of features with AirPods you may or may not know about to take your listening experience to the next level. Kurt the CyberGuy explains.
These 35 Chrome extensions have privacy and security concerns. Tech expert Kurt “CyberGuy" Knutsson says to delete them now.
Tech expert Kurt “CyberGuy" Knutsson says 329,000 mph fusion rocket promises to be fast, disruptive and enable deep-space missions.
Stay up to date on the latest AI technology advancements and learn about the challenges and opportunities AI presents now and for the future.
Tech expert Kurt “CyberGuy" Knutsson says a new autonomous AI is a game changer that also raises privacy risks. Is your data safe?
Tech expert Kurt “CyberGuy" Knutsson says robots and drones are revolutionizing fruit farming with faster picking and smarter handling.
Landmark Admin revises May 2024 cyberattack scope to show twice as many people were affected. Kurt “CyberGuy" Knutsson gives tips to help stay safe from an insurance data breach.
Tech expert Kurt “CyberGuy" Knutsson talks about how Yamaha’s hydrogen outboard motor could revolutionize boating with zero emissions.
Tech expert Kurt “CyberGuy" Knutsson reveals how to memorialize or remove a deceased loved one’s Facebook account and protect their digital legacy from misuse or scams.
Tech expert Kurt “CyberGuy" Knutsson says an Apple Watch saved psychiatrist Amanda Faulkner by detecting deadly leukemia early.
Scammers and fraudsters are increasingly targeting the most vulnerable, especially nursing homes and the personal data of their residents. Kurt the CyberGuy has safety tips.
Infected USB flash drives can spread malware among multiple organizations in ways that can easily bypass traditional security systems.
With a fully automated warehouse system and AI-powered robots, Ocado's Hive picks, packs and delivers grocery store orders in just a few minutes.
Stay up to date on the latest AI technology advancements and learn about the challenges and opportunities AI presents now and for the future.
Recycling robots are using artificial intelligence to learn how to sort recyclables by recognizing patterns in colors, textures, shapes and logos.
The Reachy 2 robot is designed to be friendly and approachable, inviting natural interaction and is perfect for research, education and experimenting with embodied AI.
Kurt "CyberGuy" Knutsson shares several easy ways to keep your credit cards safe from digital thieves while you're traveling this summer.
Arcturus sets up cameras around the edges of baseball stadiums to capture real-time action and generate a 3D digital clone of the game.
Stay up to date on the latest AI technology advancements and learn about the challenges and opportunities AI presents now and for the future.
The CyberGuy explains why healthcare organizations are vulnerable to hackers after there have been a half dozen data breaches this year.
Developed at two California universities, the innovative technology combines brain-computer interfaces with advanced AI to decode neural activity into audible speech.

Why Book Writers Need A Running Mate

By far, I have found that the lack of discipline... Read More

Conflict - How To Keep Your Readers Turning Pages

Some writers are just too kind.They hate to put their... Read More

Have You Tested Your Theme Against Your Plot?

Creative Writing Tips ?How we usually begin the preparation stage... Read More

How To Build A Successful Freelance Editorial Career

In the current job market, many editorial freelancers have turned... Read More

How to Write Funny -- Its All About Timing

My Dad has this old joke that goes, "What's the... Read More

Building a Character Wall

For any great novelist, defining your cast of intriguing characters... Read More

Writing For The Web: Where To Get Article Ideas

A friend and I were talking the other day about... Read More

Boost Your Income With Trade Journals

Why would anyone want to write for trade journals? Aren't... Read More

6 Ways to Toot Your Own Writing Horn

You know you've got writing talent. Others enjoy your work... Read More

How Three Publishing Myths Kill the Author

Agents and publishing houses have their best interests at heart,... Read More

Writing For the Joy of It

As a child, I loved to write. I can't remember... Read More

Good Writing

Good writing is like sex. Two people are involved ?... Read More

How To Become a Freelance Grant Writer

What is a freelance grant writer? These individuals have a... Read More

Know your Audience Before you Write Your Book or Web Site

If you want happy customers to use your service or... Read More

Friendly Critiques

When a writer is working on their next literary masterpiece... Read More

Making Better Word Choices ? 4 Examples

Choosing the wrong words can have a poor effect on... Read More

Creative Writing Tips - Have You Established Your Main Character At The Start?

In the beginning of your story you have to grab... Read More

Dont Forget That Manual!

No user manual? Surely you jest!It may seem comical, but... Read More

Amazing Ways Writing Articles Can Improve Your Business

How to get a lot of traffic to your website... Read More

Writing Made Them Rich #2: Charles Dickens

Charles Dickens was born in Portsea, England, in1812. His father... Read More

Writing About Writing

What am I going to write about?Which topic is the... Read More

A Writers Inner Battle

There is a psychological nuisance so powerful that can deflate... Read More

Under The Leaded Sky in Serbia by dr Mirjana Radovic

When one population in one century survived five wars, two... Read More

Frequently Asked Questions from Writers

1. What Is A Premise?A premise is the point you... Read More

Taming The Book Proposal

Taming the Book Proposal: The BasicsOh, that most maddening of... Read More

limo O'Hare Glen Ellyn ..