RE: Icons for notes, warning, etc...

Subject: RE: Icons for notes, warning, etc...
From: "Jenny Igoe" <jenny -at- fgm -dot- com>
To: "'TECHWR-L'" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 15 Aug 2003 11:47:00 -0400

Among other documentation, I maintain a System Administrator's Guide for
Solaris and Windows admins. It's in Frame, and I use icons.

Warnings get a red exclamation point inside a black triangle, notes get
a small b&w pencil point, and procedures get a solid black arrow that
resembles a triangle on its side (all go in the left margin, anchored to
the text). Next to the first two icons, the word "Warning" or "Note"
appears in bold and all caps. Next to the procedure icon is simply the
title of the procedure, also in bold (i.e. "To Install Cygwin:").

My customers have never complained about these icons, but I have a
feeling things would be different if they were removed. I think their
design keeps them from appearing juvenile or oversimplified, and I think
they're a great help to navigating the doc.

Regarding the help: no, the icons don't make it there. The on-line help
is very simple, and doesn't include any graphics, figures, tables, etc.

In short, for the actual docs I say "go, icons!" :-)


Jenny Igoe
Technical Writer
FGM, Inc.
Dulles, VA

Icons for notes, warning, etc...: From: Daniel_Hall

Previous by Author: RE: So many jobs want CURRENT security clearances
Next by Author: RE: interviews and ethics
Previous by Thread: Icons for notes, warning, etc...
Next by Thread: RE: Icons for notes, warning, etc...

What this post helpful? Share it with friends and colleagues:

Sponsored Ads