Chapter 6Concreteness

Image

You look at me as if you're in a daze

It's like the feeling at the end of a page

When you realize you don't know what you just read.

—Missing Persons

Concreteness in technical information communicates what people can see, hear, smell, taste, or touch—not just what they can think or imagine. It deals with material things and physical actions in the real world, the nitty-gritty.

Many technical subjects, such as relational database access, inheritance among classes, and communication protocols, are abstract. Users cannot experience them directly, as they can see and touch the concrete blocks in a building, for example. ...

Get Developing Quality Technical Information: A Handbook for Writers and Editors, Second Edition now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.