Everything about


Everybody talks about clean code, but what about clean comments? They are needed just as much and these posts explain why.

I recommend to read my posts on clean comments in the following order:

Image with slug comment-your-fucking-code
Comment Your Fucking Code!#post#clean‑code #clean‑comments #documentation #rant
You think your code is so clean that it doesn't need comments? Then this rant is just for you!
Image with slug thoughts-on-comments
Thoughts On Comments#post#clean‑code #clean‑comments #documentation
My rant to comment your fucking code sparked some interesting conversations. Here we discuss some of your and my thoughts on the topic of comments.
Image with slug taxonomy-comments
A Taxonomy Of Comments#post#clean‑comments #documentation
A taxonomy of source code comments that enables further discussion about clean code and comments.
Image with slug comments-costs-benefits
Costs And Benefits Of Comments#post#clean‑comments #documentation
As with most things in software development the ultimate currency for comments is time. This is an analysis of the costs and benefits of comments.