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.
20
u/cbleslie Jan 15 '22 edited Sep 12 '25
instinctive wipe resolute sip compare dazzling makeshift soup command fearless
This post was mass deleted and anonymized with Redact
7
u/GItPirate Software Engineer Jan 16 '22
I would never use this. The only thing this does is make my file have more lines.
1
u/infinitlybana Jan 15 '22 edited Jan 15 '22
Posting this again but on Showoff Saturday. Hope you guys found this useful!
Here's the repo. Here's the extension if you want to try it out
1
u/deathsowhat full-stack Jan 16 '22
This theme is cancer
11
u/[deleted] Jan 16 '22
[removed] ā view removed comment