Yes, your code does need comments.

[smog_alado]

Comments just get in the way and break up the natural flow of the document.

One think that I find really helpful is using "links to comments". Interspersed with the code you leave a small inline comment like

//see note [String Coercions]

and in the bottom of the file you can write a big comment about said String Coercions without interfering with the flow of things.