Usable Help

| | Comments (1)
Usable Help: "Examining documentation and help systems for software and consumer products."

Great content plus a great blogroll on technical writing. Recommend for all folks dealing with technical documentation (you know who you are, don't you).

(via michael-mccracken.net).

1 Comments

ce said:

I'd like to add that

* the best documentation is the one which doesn't need to be written

* an FAQ clearly shows that there are problems with the software itself


This may sound snootily if heard from a non-hacker, but it simply shows that the software model doesn't fit the user model.

Of course tech products like software need to be documented, but both the user as well as the manufacturer benefit if the amount of documentation needed gets reduced by clever software design.

Last but not least it frees human resources resp. saves some employees ;-) .

About this Entry

This page contains a single entry by HMK published on April 12, 2005 5:56 PM.

Code duplication in tests was the previous entry in this blog.

Real Artists Ship is the next entry in this blog.

Find recent content on the main index or look in the archives to find all content.