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.
Digital's Style Guide and Technical Documentation Handbook were reviewed by
Durthy A. Washington in STC's Journal (Vol. 42, No. 1).
Jackie Campana
jcampana -at- arcada -dot- com
______________________________ Reply Separator _________________________________
Subject: Re: Style Guides
Author: Gregory Keith <GKeith -at- DELRINA -dot- COM> at INTERNET
Date: 6/29/95 10:14 AM
[snip]
Well, there are good ones published by the big software players. The best
I've seen is Digital's, which is designed to be used with the Digital Guide
to Creating User Information. The two Digital docs are approx 300 pages
long, very thorough. Here's the details;
DOCUMENTATION STYLE GUIDES
Apple Publications Style Guide. (Cupertino, CA: Apple Computer, February
1994).
(Available from Apple Products Developer's Association at (US) 1-800-282-2732/
(Can) 1-800-637-0029 and on the Web at
www.info.apple.com/dev/developerservices.html, under the Publication Guides
directory. 380K compressed and binhexed.)
Digital Style Guide, by Susan I. Schultz, Jennifer J. Darrow, Frank X.
Kavanagh and Marjorie J. Morse. (Burlington, MA: Digital Press, 1993).
Microsoft Publications Style Guide. Version 1.0. (Redmond, WA: Microsoft
Corp, 1991).
Xerox Publishing Standards: A Manual of Style and Design. Xerox Corporation.
(Watson-Guptill Publications, 1988). ISBN 0-8230-5964-2.
>Do most writing groups use style guides as hard copy, on-line, or both?
We just have hard copy of ours, since we work with many outside
translators/DTP subcontractors and hard copy is easy to distribute. Also,
often when you have several apps running already and just need to quickly
check a style question, hard copy is easy to pull off the shelf. And last
but not least, we have a lot of network downtime, so hard copy avoids that
too.
Greg
Gregory Keith
Documentation Specialist
Delrina Canada
gkeith -at- delrina -dot- com
"Our minds are porous and forgetfulness seeps in: I myself am distorting and
losing, under the wearing away of the years, the face of Beatriz."
Jorge Luis Borges, The Aleph
