[snorkel]

Excellent point. Clear concise code only explains what it does, names and comments should be added to explain why it is needed, how is it being used.

[collyw]

Problem is that specs change and need tweaks afterwards. I wouldn't always think to update a method name, though I am quite liberal with comments. I guess I should start to look out for that as a way of improving my code.