RE: Writing to your audience

Subject: RE: Writing to your audience
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 23 Feb 2011 13:54:23 -0500

Why I love tech writing: "I happened to be looking up cyclohexane..."


-----Original Message-----
From: techwr-l-bounces+dgoldstein=riverainmedical -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+dgoldstein=riverainmedical -dot- com -at- lists -dot- techwr-l -dot- c
om] On Behalf Of Peter Neilson
Sent: Wednesday, February 23, 2011 1:15 PM
To: TECHWR-L
Subject: Writing to your audience

I happened to be looking up cyclohexane and came upon this short piece:

http://www.chem.yale.edu/~chem125/125/history/Baeyer/Sachse.html

It tells of Hermann Sachse's discovery in 1890 of the correct
conformational structure of cyclohexane, and of his failure to
communicate it to other organic chemists. He even made 3-D models, but
his work was rejected precisely because it required the reader to cut
out and fold a paper model. "It is not possible," wrote a reviewer, "to
write an abstract of this paper, especially since the author's
explanations are hardly understandable without models."

Sachse produced various explanations of the structure, using very hairy
trigonometry and geometry, that no chemist bothered reading. He died
three years later. The structure was not validated until 1918, and not
fully recognized until 1950.

The article concludes with:

"Know your audience, and express yourself in terms they can understand."


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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%40web.techwr-l.com


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

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat



Previous by Author: RE: WIKIPEDIA
Next by Author: RE: Custom dictionary
Previous by Thread: Writing to your audience
Next by Thread: Custom dictionary


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


Sponsored Ads