Comment Your &*☠# Code!

A heartfelt rant / thoughtful talk arguing for more comments in code

You think your code is so clean that it doesn't need any comments? Or are your colleagues convinced that all comments are failures? Then this talk is for you!

Let's first dispute some common arguments against commenting code:

  • Comments lie?
  • Tests are better?
  • Good names suffice?

We find fault with all of them (and more)!

With that out of the way we categorize comments and analyze their costs and benefits. This wills us the means to discuss the end: Which comments will improve a code base?

Of course, every team has to come up with its own answer, but the vocabulary and ideas presented in this talk can help find it.

Slides

Here's the current version of the slides.

I also embedded them below. If they're focussed, you can navigate with arrow keys or swipes (they're two-dimensional, with chapters on the horizontal axis and chapter content layed out vertically). Use Page Up/Down for linearized order and ? for more shortcuts.

Video

Here's a good recording of the talk. I hope you'll like it.

Past Presentations

I've been speaking at conferences for a few years now - prepare for a long list. 😉

2019

Tue, Sep 24th, 13:00 Europe/Berlin

Comment Your &*☠# Code!

program entry, slides, videoat Accento
Südwerk, Henriette-Obermüller-Straße 10, Karlsruhe
Tue, Mar 19th, 16:00 Europe/Berlin

Comment Your &*☠# Code!

program entry, slides, videoat JavaLand
Brühl, Phantasialand, Silverado Theater

2018

Tue, Oct 2nd, 19:30 Europe/Berlin

Comment That Damn Code!

announcement, slidesat Softwerkskammer Karlsruhe
Karlsruhe, diva-e Platforms GmbH, Ludwig-Erhard-Allee 20
Wed, Sep 12th, 18:20 Europe/Oslo

Comment That Damn Code!

program entry, slides, videoat JavaZone
Oslo Spektrum, Room 7
Mon, Jul 9th, 18:30 Europe/Berlin

Comment That Damn Code!

announcement, slidesat Write the Docs Karlsruhe
Karlsruhe, connyun GmbH, Alter Schlachthof 51

2016

Fri, Jun 24th, 10:20 Europe/Warsaw

Comment Your &*☠# Code!

program entry, slides, videoat Devoxx Poland
Krakow, ICE Congress Centre, Room 3

Looking for this?

Then you're in the right place: CodeFX.org is now nipafx.dev! It's the same content (spicy Java) by the same guy (me, Nicolai - nice to meet you!), but with a new look and without CodeFX as a middleman. From now on, it's just You. Me. Java.

Got it!

(JavaScript is off, so no cookies - tell me again next time)

Got it!

(and give me a cookie to remember - privacy policy)

Got it!

(and tell me again next time I'm forwarded)

By the way, it looks like you didn't get forwarded to the page you were looking for. If that's indeed the case, it would be great if you could let me know, so I can fix it.

Looking for this?

Then you're in the right place: CodeFX.org is now nipafx.dev! It's the same content (spicy Java) by the same guy (me, Nicolai - nice to meet you!), but with a new look and without CodeFX as a middleman. From now on, it's just You. Me. Java.

Got it!

(JavaScript is off, so no cookies - tell me again next time)

Got it!

(and give me a cookie to remember - privacy policy)

Got it!

(and tell me again next time I'm forwarded)

By the way, it looks like you didn't get forwarded to the page you were looking for. If that's indeed the case, it would be great if you could let me know, so I can fix it.