commenting code (was Re: [thelist] Tip)

Erika Meyer meyer at up.edu
Thu Feb 15 16:34:33 CST 2001


Yeah, being cutsie in comments can backfire when your readers are Evoltians 
with surly attitudes.

As for me, I really really hate comments that are all in caps.  It brings 
up bad DOS flashbacks for me.

  But when slogging thru or peeking at code, I'd personally rather see a 
thoughtful, even cutsie comment, with a blessing, a curse, whatever, 
something that shows some interest, some love... over something screamingly 
mundane and vague as:

><!--     BEGIN CONTENT     -->

but again, that's personal preference.

>and f*ing end it at that.

yeah.

>sheesh.
>sgd

<tip>
http://www.24-7cool.com/fan/jzfanclub.html
zeldman fan club
</tip>






More information about the thelist mailing list