https://phac-modelling-hub.github.io/dev-practices/day-to-day/commenting.html
Not sure if you want to mention it here, but it took me way too long to recognize the hidden cost of excessive commenting. If I comment a ton, and then come back and revise the code, unless I'm careful a lot of the excessive comments will be out of date. My more heavily commented documents that have grown organically over time are often equivalent to uncommented, since many of the comments can't be trusted.
https://phac-modelling-hub.github.io/dev-practices/day-to-day/commenting.html
Not sure if you want to mention it here, but it took me way too long to recognize the hidden cost of excessive commenting. If I comment a ton, and then come back and revise the code, unless I'm careful a lot of the excessive comments will be out of date. My more heavily commented documents that have grown organically over time are often equivalent to uncommented, since many of the comments can't be trusted.