Documentation Help Needed

RENA LEITH renaleith at sbcglobal.net
Mon Mar 19 18:41:12 MDT 2007


Several large companies have published their style guides, such as Sun and Microsoft. It's a broadening idea to look at some other industry guides as well. You could also solicit guides from Pubs departments at various companies. It might make an interesting study to look at the different approaches they take.
   
  Rena

marjheldard at comcast.net wrote:
  First off, I use the following quote from the Apple Publications Style Guide as 
my basic "style" definition:

7. A customary manner of presenting printed material, including usage, 
punctuation, spelling, typography, and arrangement.

Personally, I agree with the "you may need to familiarize yourself with more 
than one style" statement. As a teacher of both English composition and 
technical writing courses (in which I teach a fair bit of "business 
communication" concepts), I find it necessary to use both MLA and APA. When I 
teach an English 2010 course, which is humanities/liberal ed focused, we use 
MLA. When I teach English 2020, which is a science focus, we use APA. 

And then, in my technical writing courses, where I am actually introducing 
students to the world of style and usage guides, I line them all up: Chicago, 
IEEE Standards Style Manual, Microsoft Manual of Style (I don't believe this is 
the exact title...and I understand the guide is being revised...), The Apple 
Publications Style Guide, even the WIRED style guide--just to give the students 
an idea of what is available.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mailman.stc.org/pipermail/stc-ac/attachments/20070319/6b06362a/attachment.html 


More information about the Stc-ac mailing list