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.
Re: Using document conventions from the MS Manual of Style
Subject:Re: Using document conventions from the MS Manual of Style From:John Posada <posada -at- FAXSAV -dot- COM> Date:Mon, 5 Jan 1998 16:18:28 -0500
Katherin...
I use three style books in this order of priority. Understand that all of my users are UNIX-geeks and very involved in telephony systems.
1) A Style Guide for the Computer Industry, by Sun Technical Publications
2) Putting Words on Paper; A Bellcore Guide to Style, by Bell Communications Research (don't ask where to get it...it's an internal style guide that I used when I was at Bellcore)
3) MS Manual of Style
However, first and foremost, I've run all of my styles past the programmers and made adjustments where they want something different than the ones above. After all, I am writing for them.
John Posada, Technical Writer (and proud of the title)
The world's premier Internet fax service company: The FaxSav Global Network
-work http://www.faxsav.com -personal http://www.tdandw.com
-work mailto:posada -at- faxsav -dot- com -personal mailto:john -at- tdandw -dot- com
-work phone: 732-906-2000 X2296 -home phone: 732-291-7811
My opinions are mine, and neither you nor my company can take credit for them.
-----Original Message-----
From: Katherin King [SMTP:kking -at- BROOKTROUT -dot- COM]
Sent: Monday, January 05, 1998 3:50 PM
To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Subject: Using document conventions from the MS Manual of Style
Is it [computer] industry standard to use the document conventions, menu
terminology and style, etc., as described in the MS Manual of Style?
Most of my work is software documentation and I've only recently picked
up the MS Manual. As I read it, all I could think of was, "We don't do
it that way." Do most TW's follow Microsoft's conventions?
Kathy Stanzler
Technical Writer
Brooktrout Technology Inc.
Southborough, MA
(508) 229-7777 ext. 182
kking -at- brooktrout -dot- com
