Code notes: went from why bother to gotta have em

I figured comments were a waste of time when I'm coding fast. Then I opened a project from months ago and had zero clue what my own functions did. A quick vid tutorial showed how notes are like breadcrumbs for future you. Now I drop short explanations everywhere, saves my bacon later for sure.

3 comments

Log in to join the discussion

Log In

3 Comments

jordanb807mo ago

Absolutely. I used to hate writing comments because it felt like slowing down to talk to nobody. Then I spent an entire afternoon trying to crack my own code like it was some ancient puzzle. Now I treat notes like a peace treaty with the future version of me who's forgotten everything. It's not about being fancy, it's just basic self defense.

4

holly_bennett607mo ago

That "breadcrumbs for future you" thing is so true... my past self was a real jerk leaving me cryptic variable names and weird logic with no hints. I've stared at my own code like "what genius wrote this mess?" and it was me, just a few months ago. Now I force myself to write a one-line note about what a chunk does, even if it seems obvious right then. Saves me from that facepalm moment later when I have no idea what my plan was.

1

the_xena7mo ago

Do you have a system for naming things that helps you remember? I started putting three letter codes at the start of my variable names, like 'usr' for user stuff. It sounds dumb but it works. Also yeah, a short comment is way better than nothing.

5