Commenting On Commenting

Brandon Savage (May 20, 2009)
Talk at php|tek 2009 Unconference (English - US)

Rating: 5 of 5

Much has been made recently on the interwebs about what and how much to comment code. Do we document every single line? Just the broad ideas? Does good code require no comments? In this roundtable discussion, we'll (politely) debate as a group the ideas about commenting and discuss our own styles of code comments. A consensus isn't required; just a broad overview of what's out there and what people think.

Note: this will be a discussion so come prepared to participate!

 
Comments closed.

Comments

Rating: 5 of 5

May 13, 2009, 15:00 by jlleblanc

Commenting on commenting? Sounds kind of, wait for it... meta.

Speaker comment:

May 15, 2009, 14:41 by brandonsavage

I'm totally in favor of this talk. Let's do it!

Is Spam

Rating: 5 of 5

May 15, 2009, 15:29 by barry.austin

@jlleblanc - I think your comment on commenting on commenting is kind of meta. And so is this. Watch out for the singularity. Voted.

Rating: 4 of 5

May 15, 2009, 16:35 by jqs

meta

Rating: 4 of 5

May 15, 2009, 20:49 by aaronmccall

/* # // ; ' will anyone see this? I'm game.

© Joind.in 2010