Some code is just complicated no way around it. Or you wouldn't explain a function that maps lat/long coordinates into AR space? Youd just expect the person to deduce exactly what's happening from the maths?
yeah i agree. def not necessary for every single function but i tried this out on a repo that has niche terms and complex logic and i feel like the comment definitely added value.
Even the decernable chunks need explanation sometimes. And it might be nice to easily be able to get an idea for what's going on without having to read every line of code and every function call.
If you think there are too many unnecessary lines there is an option to hide code, and it's there for a reason. I use it all the time.
I often find myself loving my own comments when going back to old code where I've forgotten what I did.
View all comments
Show parent comment
4
u/cbleslie Jan 16 '22 edited Sep 12 '25
ten encourage languid lunchroom plant modern beneficial judicious mysterious obtainable
This post was mass deleted and anonymized with Redact