Re: Favorite TW Book?

Subject: Re: Favorite TW Book?
From: kcronin -at- daleen -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 10 Dec 2002 06:38:30 -0700


Trish asks:

> What is your favorite technical writing book? Why?


1) The Tech Writing Game, by Janet Van Wicklen

I always recommend this to aspiring tech writers - it gives the most
realistic picture of what we really do that I've ever seen.


2) How to Write a Computer Manual, by Jonathan Price

You gotta love it for its Zen title alone. It's been re-published with a
co-author, with minor modifications and a more verbose title (bummer).
Price was part of Apple's doc team, and coming from the company that
basically invented "user friendly," it's no surprise that he knows how to
make technical info VERY accessible to the reader.


3) Microsoft Manual of Style for Technical Publications

Gives a useful set of admittedly arbitrary rules for documenting GUI-based
products. You can either hold endless staff meetings to debate this kind
of stuff, or let a book like this make your choices for you so you can
shut up and write.


4) Read Me First! A Style Guide for the Computer Industry, by Sun
Technical Publications

A good resource for most of the scenarios we encounter: mechanics of
writing, editing, graphics and callouts, acronyms, legal stuff, etc.


5) Successful Writing at Work, by Philip Kolin

Lots of great basics for reminding yourself that you're not writing the
Great American Novel - you're at WORK.



Keith Cronin
________________________

Being a tech writer is sort of like being James Bond, except for all the
cool gadgets, the tuxedo, and the babes. Oh, and the whole license-to-kill
thing...


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Re: videotaping interviews with SMEs
Next by Author: Re: Favorite TW Book?
Previous by Thread: Re: Favorite TW Book?
Next by Thread: Re: Favorite TW Book?


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


Sponsored Ads