You know, whenever I’ve TA’d a first year class, I’ve always stressed how important it is to comment your code. That commenting provides details about what you’re trying to do and how you’re doing it. In fact, one semester, when I was posting solutions to assignments and labs, I purposely over commented the code. I wanted it to be very clear and easy for students to be able to follow what I did and why.
However, as much I’ve been great at stressing it and even using it myself to teach others, I’m terrible at using it myself. I’ll start off with lofty goals that quickly get pushed to the side. I’ve never managed to make commenting a natural part of coding for me. Which, when you end up coding a giant project (which mine is) ends up being a bit of a nightmare and often ends up making stuff a lot harder than it should be.
And so, on my giant and ever growing list of tasks, I have “go through and comment” as one of them. Of course, it’s pretty much one I’ll never be able to cross off. Even if I do take the time (and I will, I swear) to go through what I have, unless I manage to improve and forever more comment as I code, I’ll end up needing to do another pass (and another and another…). And, based on past promises on changing my ways, it’s unlikely that this is the time it’s going to work.
I think the idea of commenting code (which really boils down to making notes on something) can also be transferred to how you work on and keep track of other work. I know, that idea sounds kind of odd. Where else are the idea of comments all that useful? Well, here are some other places where I have used them in the past and think it’s worth using them in the future:
- When writing papers using Latex. You can keep track of sections you need to remove, or remind yourself why you’re including something. As you’re making progress, you can leave yourself notes about what’s missing and what you still need to do or double check.
- In your bibtex files. You can leave notes about the papers you’ve read such as where you’ve stored it or something interesting you want to remember about it.
- On your to-do lists. Many tasks can be described in a few words such as “Step 3 ideas.” But, I’ll often want to keep notes on some of the stuff I’ve already thought of or links I want to re-check out.
- On papers you’ve read. Right now, I’m using a text file to keep track of stuff, but the same idea could be used by commenting directly on pdfs and storing your thoughts that way.
And, I have to note, that I’m better at commenting/making notes on everything but code. With so much information flying around now-a-days, and the number of things we’re required to keep track of, I think remembering to take notes is becoming increasingly important. I find there’s just too many things to reliably be able to keep track of everything without notes.
Do you find you’re commenting or keeping notes all over the place? If not, what’s your secret/method to keep track of what’s going on?