I tend to prefer code that can be read without any comments, but if I
have to comment and I can choice how to do it I like a *literate
programming* style and a tool like *docco*