Who is doing great documentation?

Subject: Who is doing great documentation?
From: "Mike Hyatt" <mhyatt -at- esri -dot- com>
To: "'TECHWR-L'" <TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM>
Date: Thu, 31 Aug 2000 22:10:15 -0700

I am looking for examples of outstanding software documentation (printed or
PDF). The type of doc does not matter (user/developer/administrator/install
guide, reference manual, quick reference, tutorial, etc.), nor does the type
of application. The doc's audience can range from consumer end users to
developers. The scope of this study includes printed books and PDF documents
on CD or the Web, and excludes online help.

"Outstanding software documentation," for the purpose of this survey, is
defined as docs that are exceptional either editorially (in terms of
organization, writing and developmental editing, copyediting and
proofreading, quality of TOC and index, etc.) or from a design and
production standpoint (cover and page design, page layout, typography,
quality of illustrations/screen captures, ease of navigation, etc.), or in
both respects. For instance, Adobe's user guides and tutorials (Classroom in
a Book series) are impressive -- well organized and written, copyedited and
proofread with care, and beautifully designed, illustrated, and
manufactured.

Please name names, if possible -- of software companies that do quality
documentation, of excellent individual books or PDF docs. All suggestions,
recommendations, and opinions are welcome. I will be glad to summarize
responses.

Michael Hyatt
mhyatt -at- esri -dot- com






Previous by Author: Re: QUERY/RANT: Little Word/Acrobrat idiosyncracy... or three
Next by Author: RE: Graphics! Graphics! Graphics!
Previous by Thread: Jobs in Singapore
Next by Thread: Re: Who is doing great documentation?


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

Sponsored Ads


Sponsored Ads