introducing diagrams

Subject: introducing diagrams
From: Bruce Byfield <bbyfield -at- AXIONET -dot- COM>
Date: Fri, 3 Jul 1998 19:58:05 -0400

K McHutchion <kmchutchion -at- ENVISE -dot- COM>

>How do you introduce a graphic or diagram within a manual?

You may want to consider not using any introduction at all. For some
material,
letting the graphics speak for themselves works very well, especially
if
the graphics are closely cropped to show only what's essential.

If you do use a graphic, conventional usage is to use a colon. The
convention for using a colon is that what follows it gives more detail
about the
subject of the phrase or sentence that comes before it.

--
Bruce Byfield, Outlaw Communications
Co-ordinator ,Vancouver Technical Communicators' Co-op List
Vancouver, BC, Canada
(604) 421-7189 or 687-2133
bbyfield -at- axionet,com or bruce -at- dataphile-ca -dot- com
www.outlawcommunications.com

"I know these dark and winding streets
They're coiled around my heart,
Where time and inclination meet
And all our stories start."

- Oyster Band, "No reason to Cry"




Previous by Author: Documenting software
Next by Author: Re: Data a collective noun?
Previous by Thread: Re: introducing diagrams
Next by Thread: Addendum to Summary of Dallas TW Classes


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


Sponsored Ads