3 ms·
I write comments to myself. Why that lambda got used, where I stole it from. They're for a stranger: future me. I reread my code frequently stealing snippets
by ggm 5y ago
I write comments to myself. Why that lambda got used, where I stole it from. They're for a stranger: future me.
I reread my code frequently stealing snippets from my past self. It helps if you code well, and can remember stuff but if not, comments are the next best thing. I don't code well, my memory is shot, I need all the help I can get these last forty years.
README.md is somewhat replacing this. Typically I embed backtick quoted execution sequences, shell pipes, how I invoke this instance of that lambda, with some sugar for argument parsing, input pre-processing.
Then if you upload to some git repo you get it all: code you can search, some freetext which may match search index terms you're hunting on from the comments, and a documented example of using it on real data.
- ggm 5y agoHah. I should have read better.