pikusuru opened this issue on Oct 16, 2006 ยท 5 posts
bushi posted Mon, 16 October 2006 at 10:02 PM
Of the three, I'd always go with the last style. I use to find it extremely frustrating to go back to a script months after writing it and have to spend a lot of time trying to figure out what I'd done earlier. Being more verbose and breaking steps up into individual lines helps that greatly. Also a nice comment block for each proc with an explanation of what it's suppose to be doing, what the inputs and outputs are and an overview of the intended algorithm are very useful when updating old code.