TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Chuck Banks wrote:
>At NECAM, we use a non-proportional font for command names, sample
>commands, etc. In FrameMaker, we use Courier bold. In Xerox GlobalView,
>we use Terminal bold or Bold PS. The change in font provides some
>structural advantages (examples on the page or screen appear much as
>they do on actual displays), and no one has complained that such
>bolded characters distract or confuse them.
We use a similar convention, except that *commands the users enter* are in
Bold, while code and screen text displays are in Medium Courier. This works
well to distinguish between what they see and what they type. Any commands they
key in are on their own line, which avoids having to use quotes around the
strings.
Michael McClatchey
Senior Technical Writer
Applied Intelligent Systems, Inc.
110 Parkland Plaza,
313-995-2035 / FAX 313-995-2138 Ann Arbor, MI 48103
(NeXTMail welcome)
(opinions expressed are not necessarily those of my employer)
