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





Previous by Author: Re: The Writer's Kit
Next by Author: Re: Contractors of Questionable Ability
Previous by Thread: Using document conventions from the MS Manual of Style
Next by Thread: Re: Using document conventions from the MS Manual of Style


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


Sponsored Ads