Re: OT: Quick poll

This WebDNA talk-list message is from

2003

It keeps the original formatting. numero = 53560
interpreted = N
texte = I put very sparing notes in my WebDNA code, as every comment creates parsing overhead on the server. Of course, my code is so elegant and well written that it doesn't need any comments :)I have found that one large comment block parses quicker than multiple small ones, so I put most of my comments at the top of each file, with only enough notes in the code itself to remind me of what the heck I'm doing when things get ugly.I've become religious about tracking my changes in the header comment block with something like this:[!] Document:(name of the html or include file)Usage:(what this file does, why and how)Input:(list of parameters to an include file, formvariables to an html page, and their usage)Output:(what gets returned from an include file)Change Log:DateWhoChanges21Oct2002Brian FriesInitial development06May2003Joe Schmoe(what joe did, brief yet complete)09Oct2003Brian Fries(what I did, brief yet complete)Copyright 2002-2003, BrainScan Software[/!]- brianOn Thursday, October 23, 2003, at 10:59 PM, Andrew Thompson wrote:> Just intrigued by something and want to get a quick sounding from the > list:>> // how many of you write notes in your code so if you get run over by > a bus, the poor sucker who picks up your strings of genius knows what > the heck is going on? //>> Look forward to hearing from you.>-- Brian Fries, BrainScan Software -- http://www.brainscansoftware.com ---------------------------------------------------------------This message is sent to you because you are subscribed to the mailing list .To unsubscribe, E-mail to: To switch to the DIGEST mode, E-mail to Web Archive of this list is at: http://webdna.smithmicro.com/ Associated Messages, from the most recent to the oldest:

Re: OT: Quick poll ( "Dan Strong" 2003)
Re: OT: Quick poll ( Pedro Rivera 2003)
Re: OT: Quick poll ( Donovan Brooke 2003)
Re: OT: Quick poll ( Brian Fries 2003)
Re: OT: Quick poll ( Pedro Rivera 2003)
OT: Quick poll ( Andrew Thompson 2003)

I put very sparing notes in my WebDNA code, as every comment creates parsing overhead on the server. Of course, my code is so elegant and well written that it doesn't need any comments :)I have found that one large comment block parses quicker than multiple small ones, so I put most of my comments at the top of each file, with only enough notes in the code itself to remind me of what the heck I'm doing when things get ugly.I've become religious about tracking my changes in the header comment block with something like this:[!] Document:(name of the html or include file)Usage:(what this file does, why and how)Input:(list of parameters to an include file, formvariables to an html page, and their usage)Output:(what gets returned from an include file)Change Log:DateWhoChanges21Oct2002Brian FriesInitial development06May2003Joe Schmoe(what joe did, brief yet complete)09Oct2003Brian Fries(what I did, brief yet complete)Copyright 2002-2003, BrainScan Software[/!]- brianOn Thursday, October 23, 2003, at 10:59 PM, Andrew Thompson wrote:> Just intrigued by something and want to get a quick sounding from the > list:>> // how many of you write notes in your code so if you get run over by > a bus, the poor sucker who picks up your strings of genius knows what > the heck is going on? //>> Look forward to hearing from you.>-- Brian Fries, BrainScan Software -- http://www.brainscansoftware.com ---------------------------------------------------------------This message is sent to you because you are subscribed to the mailing list .To unsubscribe, E-mail to: To switch to the DIGEST mode, E-mail to Web Archive of this list is at: http://webdna.smithmicro.com/ Brian Fries

DOWNLOAD WEBDNA NOW!

Re: OT: Quick poll

2003

Top Articles:

Related Readings: