Comments and explanations - how to do it better?

Writing code is social communication first of all.

That is the best explanation I have read yet.

"Writing code is social communication first of all."

That is brilliant - thank you.

Paul

That's a huge stretch, but the general idea is true indeed - if it was only intended to be read by a machine, it would be binary and not human-readable.