Quotation marks around user interface labels

Subject: Quotation marks around user interface labels
From: Nancy Allison <maker -at- verizon -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Mon, 18 Jul 2011 16:05:19 -0500 (CDT)

Hi, all.

I seem to have lost my bearings about when to use quotation marks. I'm working on release notes that describe fixes to individual check boxes and fields in the user interface.

What would you for a sentence like this:

---Added a check on Out of Office reply in the Scheduling Conditions section before the Print routine.

I wouldn't use quotation marks or a special font for any of that, would you? Aren't the capitals enough to make it clear that proper names are being used?

But what about this:

---Fixed the bug that prevents Diagnostic: Outboard from being deleted.

That looks more like a heading that might be generated and displayed for a while under certain circumstances. I might be tempted to put quotation marks around "Diagnostic: Outboard."

The problem is made more difficult by the fact that I don't have time to check all these things out in the user interface. Even if I did, I don't know how to set up the conditions that generate some, or even a lot, of the errors that have been corrected.

I'm really working in the dark and on a tight deadline, too.

Do you have a rule of thumb about using quotation marks for field names, dialog box titles, message text, and the like?

Thanks for any and all suggestions.

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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%40web.techwr-l.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/ for more resources and info.

Please move off-topic discussions to the Chat list, at:


Previous by Author: Format the TOC in HTML Help?
Next by Author: RE: Quotation marks around user interface labels
Previous by Thread: Re: Surprisingly quiet today
Next by Thread: Re: Quotation marks around user interface labels

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

Sponsored Ads