Does exactly what it says on the tin

Saturday, February 6th, 2010

“Does exactly what it says on the tin.”

I love it. All of our method and function names should do exactly the same.

During a discussion with the ColdFusion on Wheels core team about the valid() and beforeValidation() methods, Andy Bellenie made this remark:

My point is that a callback called beforeValidation should run, well, before validation – not during it. This seems self-evident to me and I’d have a hard time explaining to anyone why it should work differently.

Then he pointed to “the Ronseal test, the holy grail of method naming.”

Thanks Andy for the inspiration.

Technorati Tags: , , , , , , , , ,

This entry is filed under ColdFusion on Wheels, Programming. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

2 Responses to “Does exactly what it says on the tin”

  1. Andy Bellenie Says:
    February 9th, 2010 at 11:47 am

    Hahahah wasn’t expecting that :) Thanks Chris, eventually I hope to have the phrase ‘Ronseal test’ established as the de-facto standard for method naming :)

  2. Chris Peters Says:
    February 14th, 2010 at 10:05 pm

    Hey, I was particularly inspired by the metaphor and actually had a few minutes to blog. So there you are.

    I hope that this post contributes in at least the smallest way toward establishing the standard.

Leave a Reply