Re: Code comments as Documentation

Subject: Re: Code comments as Documentation
From: Seth Johnson <seth -dot- johnson -at- RealMeasures -dot- dyndns -dot- org>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 30 Sep 2004 14:35:42 -0400



Diction. "Pathetic" is a stinging word. Phrase the sentence
otherwise, maybe you can even use the word "pathetic." But
nope. That's sentence is a sting. A smiley could have mitigated
it, perhaps enough.

A perfect example of what to watch for when writing to email
lists.


Seth


TechComm Dood wrote:
>
> > > What a pathetic viewpoint.
> >
> > Discussion that sinks to this level is not discussion at all. Play nice, or
> > play alone.
>
> I'm sorry, but how is this not playing nice, exactly? It's my
> understanding that viewpoints, thoughts, and ideas were all fair game
> here.
>
> Someone also commented about sticks and stones...
>
> I'm terribly sorry you took my reply as a personal attack, but if you
> re-read it you should notice that it was not.

--

DRM is Theft! We are the Stakeholders!

New Yorkers for Fair Use
http://www.nyfairuse.org

[CC] Counter-copyright: http://realmeasures.dyndns.org/cc

I reserve no rights restricting copying, modification or
distribution of this incidentally recorded communication.
Original authorship should be attributed reasonably, but only so
far as such an expectation might hold for usual practice in
ordinary social discourse to which one holds no claim of
exclusive rights.


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

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -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.



References:
RE: Code comments as Documentation: From: Michael Strickland
Re: Code comments as Documentation: From: TechComm Dood

Previous by Author: Re: Code comments as Documentation
Next by Author: Re: Finding differences between files.
Previous by Thread: Re: Code comments as Documentation
Next by Thread: RE: Code comments as Documentation


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


Sponsored Ads