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:Tracy Boyington <trlyboyi -at- GENESIS -dot- ODVTE -dot- STATE -dot- OK -dot- US> Date:Tue, 9 Jan 1996 11:37:29 +0000
> In technical writing, one reason for leaving the period outside the
> quotation marks is that a user does not SEE the period on the item in
> the menu. It could be confusing in some situations, though probably
> not in the example here. A better approach would be to leave off the
> quotation marks and, if necessary, bold the words Edit and Cut. In
> fact, I can't recall ever seeing any user guides that DID use
> quotation marks for commands or menu items.
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?
Technical Communication Specialist
Oklahoma Department of Vocational & Technical Education
I never express opinions, but if one slips out, it belongs
to me and not ODVTE.
"I think I did pretty well, considering I started out
with nothing but a bunch of blank paper."
-- Steve Martin