It could be a hassle to keep comments as up to the date as the code they are meant to accompany, that I totally agree but I would argue with these main 2 reaso

It could be a hassle to keep comments as up to the date as the code they are meant to accompany, that I totally agree but I would argue with these main 2 reasons on why I prefer to comment as much as possible and update them as often as the code: 1) I am fairly certain that the next maintainer of my code would appreciate a well-written piece of code with proper explanation for especially clever portions or just plainly horrifying practices done for a production bug fix which must go out in minutes and the poor soul responsible for that already forgot about fixing the fix :). 2) Someone may remember every lines of code that they wrote in the past 3 months or so but I would not. I tend to forget code rather quickly so my comments serve as a memento to my future self, meaning I would do well to keep my comments up to date.