Re: Your typographical conventions

Subject: Re: Your typographical conventions
From: Nancy Allison <maker -at- verizon -dot- net>
To: Chris Vickery <cvickery -at- arenasolutions -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 08 Mar 2007 16:46:27 -0600 (CST)

Chris says:

>In my manual I use bold for button names and commands, and italics for
>radio button selections or choices in drop-down menus.

I'm curious. Why make the distinction between these two sets of items?

>We end up with sentences where the same word can be used generically, so
>it's lowercase, and also used to name a specific app concept, so it's
>uppercase. The word "File" for example.

Oh yes. All you can do is hope that your reader is literate enough to understand why -- otherwise, the documentation takes a hit in credibility because of the poor literacy of the reader!

(Just like the need never to split an infinitive or end a sentence with a preposition, not because those rules have had any serious weight for the past 100 years, but because readers and even in-house reviewers still perceive the text as incorrect and the writer as an ignorant fool. Aarrrgh.)

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

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

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 for more resources and info.


Previous by Author: Your typographical conventions
Next by Author: Friday question: Your fave game
Previous by Thread: RE: Your typographical conventions
Next by Thread: Re: Your typographical conventions

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

Sponsored Ads