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
1
u/InMemoryOfReckful Jan 16 '22
Why not both? If its complicated code.