Re: Style question about quotes

Subject: Re: Style question about quotes
From: "hbacheler" <hbacheler -at- aol -dot- com>
To: "Brasel, Russell" <russell -dot- brasel -at- hccredit -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 27 Nov 2006 13:13:35 -0500

Russell,

I have made it a HABIT/REQUIREMENT for my documents to have ALL 'buttons, keys, etc.' to be "ALL CAPS, BOLD" without quotation marks. That way there is no misinterpretation, and they STAND OUT in the document.

this was specified.In a document style guide that I helped develop for a US Government agency.

Having been involved with various industry styles (i.e., IBM, NCR) since the early 1980's the styles that I have encountered. reinforce this approach.

Consistency works, regardless of the way keyboard key caps are made, or how the displays on the screen appear,

I welcome comments on this approach.

HTH,

Harry Bacheler
hbacheler -at- aol -dot- com


----- Original Message ----- From: "Brasel, Russell" <russell -dot- brasel -at- hccredit -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Sent: Monday, November 27, 2006 12:29 PM
Subject: Style question about quotes


I'm revising a document that predates my employment. It's only a
procedure manual, and a small one at that, but when referring to a field
that appears in the program (and the accompanying screenshot), the text
is:

Clicking the 'New App' button creates a new UAI record.

Don't worry about UAI-that's our internal acronym-but we have a New App
button. How do the rest of you include field labels and button names in
your documents? I've looked at MS Manual of Style, and don't consider
it gospel.

RGBrasel
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as hbacheler -at- aol -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/hbacheler%40aol.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today! http://www.webworks.com/techwr-l

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
Style question about quotes: From: Brasel, Russell

Previous by Author: Re: Landed my first job as a technical writer
Next by Author: Re: How many technical writers wear different hats?
Previous by Thread: Style question about quotes
Next by Thread: RE: Style question about quotes


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

Sponsored Ads


Sponsored Ads