This evening I read Bill Horton's Illustrating Computer Documentation, the Art of Presenting Information Graphically, On Paper and Online. (1991)
What a practical book! Now out of print, you can buy an electronic copy for $20 from Bill's website. Such a deal.
Bill goes on to give lots of information about color, some of it, ah, eye-opening. What freaks me out is how little use of color one finds in books, cases, "white" papers, and so forth.
The next chapter, Enriching Graphics, describes such things as how to number graphics and captions. Captions! Authors will spend hours getting the words just right or diddling over a comma, but dash off captions as if they were a useless bother. I have news: People read subheads, then captions, and then, if they're still on board, the body copy.
Fortunately, ...enlightened writers and graphic designers now realize that their job is not to put words on paper or to make pretty pictures but to communicate. They are taking steps to put text and pictures together into effective pages."
So many reminders. Page design. Cultural nuances. Symbol libraries. On and on. Illustrating Computer Documentation is chock full of rules of thumb and practical advice.