The importance of comments - Part 3
Counterarguments and commenting the Why
This is the third and last post discussing the value of comments in code.
A note about eventual consistency - Part 2
The importance of comments - Part 2
Commenting the What
This is the second post discussing the value of comments in code.
The importance of comments - Part 1
The confusion and (not) commenting the How
I wrote about the importance of documentation a few weeks ago. In this post I will discuss a related, also controversially discussed topic: Comments.
Don't make me think!
Avoiding concept spill in API design
API design is a huge topic these days and you find a lot of information about how to design good APIs. Unfortunately, most of it is about tools or technology: Use Tool X for great APIs! Use technology Y and everything will be fine!
The importance of documentation
Unloved, maligned, yet much needed
Documentation – not only since the rise of Agile a controversially discussed topic in IT. On the one hand, we see a lot of demand for documentation by many parties. On the other hand nobody wants to create it.
