Thread: The SQL Class
View Single Post
Old 01-16-2009, 04:46 AM   #30 (permalink)
Village Idiot
Wizard
Top Contributor 
 
Village Idiot's Avatar
 
Join Date: Sep 2007
Posts: 1,299
Thanks: 17
Village Idiot is on a distinguished road
Default

Another thing that would be good if you could change is the comments. Comment the purpose of the variable/function, but why restate the parameter list? Parameters are just as easy to read as is opposed to in a comment. What really needs to be commented is are the commands. I honestly had a hard time understanding a few parts of the class, comments on the purpose of that part of the code would have made things a lot easier.

I will establish a commenting convention in the next few days, but just stick to the theory that comments are made to state the non-obvious and nothing more.
__________________

Village Idiot is offline  
Reply With Quote