"The reader must read and understand it in any case." Because in the cases wherein the code is abstract or dense, a little 'English' can go a long way. Especi

"The reader must read and understand it in any case." Because in the cases wherein the code is abstract or dense, a little 'English' can go a long way. Especially when making use of APIs that are weird and have weird behaviours. AKA: "I'm breaking xyz convention here because API abc has the following odd, undocumented behaviour (i.e. returns nulls when it should not)" Comments are not always good, but if there is any reasonable thoughtfulness to them, they will be 'mostly good'.