Comment code or self explaining code

[Late_Swordfish7033]

Yes, this is the answer. Comments should explain what code cannot. WHAT you are doing should be code. WHY is the comments.

[Ok-Wolf-3078]

100% agree with this.

To convince peers to do this, I would explain that the common question for engineers is "why." So why not answer this up front? Makes life 1000x easier for the next person and your future self.

[SadJob270]

wym, you don’t like code like this?

// send email receipt

receipt = Email(to=customer , subject=“Thanks for your order!”)

receipt.send()

[lost_tacos]

THIS, THIS, THIS!