OJ's rants

It's not about you, it's about the software

// TODO: Add Comments

| Comments

All too often have I seen comments like this. That’s if I’m lucky enough to see comments at all! I’m quite a big advocate of comments in code. I don’t agree with the age-old philosophy of:

If the code was hard to write, it should be hard to read as well!
I read a cool article this morning called In Praise of the Lowly Comment, which I think hits the mark nicely. I think I might just email this link around to my current workmates, as I don’t think they realise that commenting should consist of more that ‘TODO’s.

Comments