When is a screenshot really useful in training documentation?

It all comes down to the familiarity of the audience with the interface. The words of a procedure describe parts of the interface. Will the audience immediately recognize which parts of the interface those words refer to? If yes, then screenshots are unnecessary and will simply slow the reader down. If no, then you need a way to show the reader which part of the interface the words refer to, and a screenshot is one way to do that.

As computers have become more ubiquitous, interfaces have become more standardized, and people do more and more activities on the computer, people have become more familiar with interfaces and thus more likely to recognize what the words in the procedure refer to. Thus we have more shortcuts like File > Print, because people now know what that means.

There is a universal phenomena here: as products become ubiquitous and users become experienced with them, the need for documentation diminishes, and may eventually disappear altogether. Thousands of products ship with no documentation other than that demanded by lawyers. It is all about where your product fits on the familiarity scale with its intended audience. This affects far more than just the decision about screenshots.

But there are still specific cases in which the audience may not know what the words in the procedure mean. If the audience is inexperienced or the interface is non-standard, the reader may not recognize what the words mean and you should use screen shots.

In some cases, there may be small parts of the interface that are non-standard, meaning you should use screenshots for those parts and not for others.

In short, therefore, use them where you anticipate that a significant portion of you audience may need them, and otherwise not.

posted over 8 years ago

CC BY-SA 4.0

Mark Baker‭

4371 reputation 12 1104 744 58

Does the screenshot add to what you're saying, or is just there to be pretty? I think that marketing materials should be "pretty", but technical work should focus on teaching and understanding.

Remember, too, that you should make all of your documentation accessible to users who have less than perfect vision.

posted over 10 years ago

CC BY-SA 3.0

Joe Malin‭

20 reputation 0 2 4 0

I've written about this subject before.

SW documentation is often reused for different versions of the same software. Therefore, it is important to minimize the number of screen captures you use. Why?

• Using out-of-date screen captures causes a lot of confusion.
• Replacing/updating screen captures is a lot of work.
• Unless it is difficult to do, screen captures should always be accompanied by a caption that explains what is useful and/or important about the screenshot. Instead of using the generic “Save As Dialog,” you should say “Ms Word lets you save in various formats” and then show the dropdown box of all the formats that MS Word saves in.
• Screen captures use a lot of real estate and generally shouldn’t be used for long topics. If there’s more than three screenshots on a single page, something is probably wrong.
• The best time to use screen captures in documentation is to reveal a non-obvious feature or to show what SW looks like when it is processing live data.
• Best contexts for using screenshots? They are especially good for novice users and illustrating problem states in software.
• Screencasts are also becoming efficient methods for conveying the general sense of a user-interface. They are especially effective for quick tours and to illustrate the overall flow of work in a short period of time, but they still are no substitute for conventional documentation.

posted over 6 years ago

CC BY-SA 3.0

idiotprogrammer‭

55 reputation 1 8 11 0