Scripting Best Practices Sep 2, 2008, 19 :03 UTC (0 Talkback[s]) (4019 reads) (Other stories by Juliet Kemp)
"Ideally, most of your code should be crystal clear without comments (this is where your variable names come in, for example). But having at the least a comment up top saying what the script does, what input it expects, and what output it provides, will be incredibly helpful in the future."