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.
Your typographic conventions and justification for
Subject:Your typographic conventions and justification for From:Nancy Allison <maker -at- verizon -dot- net> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Thu, 04 Feb 2010 10:20:40 -0600 (CST)
What fonts do you use in your documents (beyond the usual body text, header, footer, and heading fonts)? Our body text font (for PDFs) is Times New Roman. We document hardware and user interfaces, but not internal software programming, so beyond giving installation and upgrade instructions, we don't deal with code-related terms.
We use these typographical conventions:
--Bold Arial -- anything the user selects or clicks, or any text the user enters. Also all Note, Caution, and Warning text (which is set off by leading above and below and marked by an icon to the left. In addition, Warnings are set off by a black box.)
--Italic -- introducing new terms, titles of publications.
--Monospace -- system error messages and prompts, (and code samples, which are extremely rare for us).
You see that we keep alternate typefaces to a minimum.
We capitalize the titles of UI windows, dialog boxes, prompts, etc. but do not use a different typeface. Oh, dear, I see that the Microsoft Manual of Style 3rd edition recommends bolding the names of dialog boxes. I don't see a need for it -- isn't the capitalization enough of a hint?
I remember documents, at other clients, that had to have a lengthy table at the front explaining the significance of 5 or 6 typefaces. It seemed to be unduly complicated and we doubted that it was helpful for readers. In the years since, I have observed a trend toward simplification, which I support.
I am preparing for a discussion of this issue and wondered what other tech writers do. What do you do, and what reference books or standards do you rely on? Can you recommend any other books or standards for me to take a look at?
Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at: http://www.doctohelp.com/
Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at: http://www.ModernAnalyst.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-