Skip to content

Code comments. Yay or nay?

Photo of Björn Wewer
Hosted By
Björn W.
Code comments. Yay or nay?

Details

Hello People!

We will have a "real talk" at this meetup!

Nicolai Parlog had some kind of breakdown when working on some code and that discharged into his blog post "Comment your fu$%&ing code!" (link below, reader discretion is advised ;-) ).
This post started several discussions on clean code mantras vs benefits of comments and Nicolai took a deeper dive.

And the best part is that he is willing to share his experience with us! Here is the abstract:
____________________________________________

# Comment That Damn Code!

Unlike others I don't believe that all comments are failures, that code can be so clean that it doesn't need any comments. In this talk I'll 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 can improve a code base?

____________________________________________

https://blog.codefx.org/techniques/documentation/comment-your-fucking-code/

Photo of Write the Docs Karlsruhe group
Write the Docs Karlsruhe
See more events
Körber Digital GmbH
Alter Schlachthof 51, 76131 · Karlsruhe