you are viewing a single comment's thread
view the rest of the comments
[–] 20 points 2 years ago (1 child)

Lead of a small team of scripters here. The "Why. Not What" is defo a good way of encouraging cleaner code.

Had to request changes recently on a PR like this, big function with comments telling me what it was doing. When they resubmitted for review they had broken it down into smaller functions with good variable/function naming. following what was going on was much easier

  • source
  • parent
  • hideshow 1 child comment
  • [–] 1 point 2 years ago

    Same strategy here, but recently found myself commenting on the “what”. There was a perfect built-in, but not really readable and I couldn’t figure out how to make it readable, so fine

  • source
  • parent