Summary of examples of GOOD Technical Writing

Subject: Summary of examples of GOOD Technical Writing
From: jsokohl -at- mac -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 1 Jul 2002 9:54:48

Hi all,
Well, my request for examples of really good tech writing elicted only four

* Three ?wow, great question, looking forward to your results? comments.
* One ?I?m working on an article about this topic so you can?t have my
info? response.
* And one bona fide submission. Meg said, ?For the lets-get-this-job-done
documentation, I love The Linux Documentation Project( Many authors, many writing styles. Content quality
varies considerably. The bottom line is that the writing is practical, to
the point, and highly on-topic.?
Thanks, Meg!

With that in mind, I?ll simply share my favorites. Most of these are Apple
related, simply because I think that, through the years, the Apple
technical writers have done a wonderful job. But that?s just my opinion.
I?ve sorted these by doc types: Discussion, Reference, and Procedure. Hope
you enjoy,
PS Unfortunately, some of the URLs are really, really long. You might have
to do some cutting & pasting...
Macintosh Human Interface Guidelines (one of the core HCI documents):
WebObjects Overview:

Newton Programmer?s Guide:
Most of Sun's reference stuff

Apple: Getting Started with HyperCard 2.3:
NewtonWorks Word Processing User?s Manual:
Apple OpenDoc Learning About OpenDoc:
Deneba Canvas 8.x User?s Guide: (I like the writing, but the
usability of the site leaves much to be desired--a straight PDF would be so
much easier)

Save $600: Create great-looking Help files and software demos with
RoboHelp Deluxe. Get RoboHelp and RoboDemo - our new demo software - for one
low price. OR Save $100 on RoboHelp Office in June with our mail-in rebate.
Go to

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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 for more resources and info.

Previous by Author: RE: Voice Recognition Software...
Next by Author: Re: the other one...RE: why people don't read manuals
Previous by Thread: Re: Free/open source knowledge base system
Next by Thread: Re: Summary of examples of GOOD Technical Writing

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

Sponsored Ads

Sponsored Ads