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.
Subject:Re: Quote Marks From:Bonni Graham <bonnig -at- IX -dot- NETCOM -dot- COM> Date:Wed, 10 Jan 1996 10:56:32 -0800
>So, while we're all here, let's come up with a good way to do this.
>I've used italics for things the user types, small caps for keys
>(such as ENTER or F3), bold for menu commands. I'm not saying
>these are best; just that this is what I've used. And the punctuation
>situation has always bothered me. What does everybody else do?
I've used bold for menus and strings of user-entered text (unless
they're really long, then I give 'em their own paragraph in a
monospaced face) and keypress fonts for individual keys, where I can
(bold if I can't use a keypress font).
I know this tends toward the raisin-cookie effect, as its been called
before on this list. I don't know that that's a bad thing, though --
I've seen people read manuals where all they do is look for the bold
stuff and maybe skim the words immediately on either side.
YMMV -- have the usability folks looked into this at all?
bonnig -at- ix -dot- netcom -dot- com