Developer comments

I don't know why anyone would think Developer Comments were not best practice. Commenting code is a must to explain the why and the what of the code when the code in itself is not self-explanatory. The principle is that you should put yourself in the shoes of someone else who is seeing your code for the first time and what they might find useful in order to maintain it. Think what you would like to see if you were looking at some new code for the first time and then leave the comments you'd like to see.

I don't know why anyone would think Developer Comments were not best practice. Commenting code is a must to explain the why and the what of the code when the code in itself is not self-explanatory. The principle is that you should put yourself in the shoes of someone else who is seeing your code for the first time and what they might find useful in order to maintain it. Think what you would like to see if you were looking at some new code for the first time and then leave the comments you'd like to see.

I recall seeing an issue where lengthy comments actually impacted interface performance. Maybe that drove this perception? Probably resolved by now, though.