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'll find fault with all of them (and more)!
With that out of the way we'll categorize comments and analyze their costs and benefits. This will give 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.
Nicolai is a thirty year old boy, as the narrator would put it (if he squints), who has found his passion in software development. He constantly reads, thinks, and writes about it, and codes for a living as well as for fun.
Nicolai is a freelancing developer, author, and trainer. He wrote The Java Module System with Manning, blogs about software development on codefx.org, has a YouTube channel, and is a long-tail contributor to several open source projects. You can hire him for all kinds of things.