minus-squareMajorHavoc@lemmy.worldtoProgramming@programming.dev•What are your programming hot takes?linkfedilinkarrow-up0·2 years agoThere’s no such thing as self documenting code, unless every method and variable name has the word “because” in it. Anyone can read what the code does. The comments are there to answer why it does what it does the way it does. Why is invariably lost to time, if it’s not committed to a comment here and there. linkfedilink
minus-squareMajorHavoc@lemmy.worldtoAsk Lemmy@lemmy.world•What is something really stupid you purchased that turned out far better than expected?linkfedilinkarrow-up1·2 years agoI see what you did there. Well, I half see it, anyway. linkfedilink
There’s no such thing as self documenting code, unless every method and variable name has the word “because” in it.
Anyone can read what the code does. The comments are there to answer why it does what it does the way it does.
Why is invariably lost to time, if it’s not committed to a comment here and there.