RE: Examples of good tech writing?

Subject: RE: Examples of good tech writing?
From: "Nuckols, Kenneth M" <Kenneth -dot- Nuckols -at- mybrighthouse -dot- com>
To: "Larry Kunz" <larry_kunz -at- symantec -dot- com>, <TECHWR-L -at- LISTS -dot- TECHWR-L -dot- COM>
Date: Wed, 11 Jan 2006 11:32:21 -0500

Larry Kunz said...
>
> How to Keep Your Volkswagen Alive: A Manual of Step-by-Step Procedures
> for the Compleat Idiot, by John Muir.
>
> Despite being highly nonmechanical, I used this book in the late '70s
> and early '80s to keep my '64 Beetle going. I still don't know of a
> better technical manual. It takes you from changing the oil to
adjusting
> the brakes to rebuilding the engine -- if you're so inclined.
>
> Muir passed away years ago, but his successors have kept on updating
his
> book, now in its 19th edition. It strikes the perfect balance between
> informative and whimsical. (If you don't think that can be done, buy
the
> book and see for yourself.) The illustrations are wonderful.
>
> A reviewer on Amazon hit on just the right word for this book:
> "empowering."
>

I've never read the VW book, but it sounds like it might share some
literary genetic traits with _Zen and the Art of Motorcycle Maintenance_
by Robert Pirsig. I had a TW professor (who also taught Lit. classes)
that really loved that one. I don't know that I would recommend it as an
example of good Technical Writing. However, I do remember pretty vividly
some passages on the quest for quality that might form someone's
philosophical approach to whatever vocation they pursue, be it engineer,
mechanic or authoring technical documentation.

CONFIDENTIALITY NOTICE: This e-mail may contain information that is privileged, confidential or otherwise protected from disclosure. If you are not the intended recipient of this e-mail, please notify the sender immediately by return e-mail, purge it and do not disseminate or copy it.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: RE: Friday Poll Idea (WAS: In love with a word)
Next by Author: CD-Rs vs. Store-bought CDs (WAS: Do Burned CDs Have a Short Life Span?)
Previous by Thread: Examples of good tech writing?
Next by Thread: Re: Examples of good tech writing?


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


Sponsored Ads