RE: document your job?

Subject: RE: document your job?
From: "Porrello, Leonard" <lporrello -at- illumina -dot- com>
To: Dan Goldstein <DGoldstein -at- riveraintech -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 11 Jul 2012 21:18:03 +0000

Documenting what you do for your own benefit is not a bad idea. From an ethical perspective, however, it is not as black and white as Dan suggests. It clearly becomes a question of professional ethics only when Kevin is tasked with documenting what he does. Otherwise, you need to weigh the opportunity cost of documenting the job (against using that time to write and improve documentation).

It is also not a question of doing it out of gratitude for 20+ years of employment. Unless Kevin's employer has kept him on for charitable reasons, it is safe to assume that the relationship has been mutually beneficial.

-----Original Message-----
From: techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Dan Goldstein
Sent: Wednesday, July 11, 2012 1:57 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: document your job?

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 know?"

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
RE: document your job?: From: Dan Goldstein

Previous by Author: RE: Technical Writing vs. Professional Writing
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