Your typographical conventions

Subject: Your typographical conventions
From: Nancy Allison <maker -at- verizon -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 08 Mar 2007 15:07:24 -0600 (CST)

I'm working on a docset that will be distributed as PDFs. It's about a software application.

At my last gig, we had a font for everything under the sun. The Typographical Conventions table pretty much filled an entire page. It was overkill. If readers noticed it at all, I suspect they may have had a sinking feeling as they thought, "Am I supposed to remember this??" Of course, they're not. The fonts are supposed to be an aid, not a burden, and in my view the reader shouldn't have to be critically aware of them.

What would you pick out in special fonts?

I'm leaning toward having only these:

Titles of documents, and emphasis: italics
Code and system messages: Monospaced font
User actions (data entered, menu picks, buttons clicked): bold

I *think* simple capitalization is enough to set off field names, window titles, etc. But this is the one I'm waffling on.

What are your minimum special fonts for a software doc?

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: Re: Re: The good old days.
Next by Author: Re: Your typographical conventions
Previous by Thread: Re: WordStar
Next by Thread: RE: Your typographical conventions

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

Sponsored Ads