RE: document your job?

Subject: RE: document your job?
From: "Dan Goldstein" <DGoldstein -at- riveraintech -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 11 Jul 2012 16:56:51 -0400

I consider it part of my professional ethics to leave clear
documentation for those who will follow. Most of us have picked up a
project where someone unnecessarily left us a mystery... or a mess.

To be clear, I'm not just talking about predecessors and successors. Ten
years from now, the poor schmuck who has to figure out what I was doing
this week might well be me.

Happy Wednesday!

- Dan Goldstein

P.S.: I try to avoid the "hit-by-a-truck" scenario. Instead, I always
say to my colleagues whose work I document: "If you were to win the
lottery tomorrow and move to Hawaii, what would the rest of us need to

-----Original Message-----
From: McLauchlan, Kevin
Sent: Wednesday, July 11, 2012 4:22 PM
To: Dan Goldstein; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: document your job?

That's a throw-away comment unless you elaborate.

> From: Dan Goldstein
> Yes: Professional ethics.
> -----Original Message-----
> From: Editor in Chief
> Sent: Wednesday, July 11, 2012 3:32 PM
> ... Is there a good reason, from the writer perspective, to pull all
> the documentation for such an environment together in one place, one
> document? Without the carrot/stick of ISO preparation looming?...

This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.

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.


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-leave -at- lists -dot- techwr-l -dot- com

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

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


document your job?: From: Editor in Chief
RE: document your job?: From: Dan Goldstein
RE: document your job?: From: McLauchlan, Kevin

Previous by Author: RE: document your job?
Next by Author: RE: document your job?
Previous by Thread: RE: document your job?
Next by Thread: RE: document your job?

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

Sponsored Ads