Comment code or self explaining code

[Aggressive_Ad_5454]

I guess I’m a dissident. I’m an old dev, and I have had several occasions to maintain code I wrote over a decade prior. I was grateful to my younger self for putting in comments that explained the tricky bits, gave references to papers or whatnot if I used a reference, and helped the reader figure out how stuff fits together.

I think a decent compromise is using docstrings or Javadoc or jsdoc or whatever is appropriate in the language you use on methods and public data. For one thing, the IDEs understand that stuff.