News for hackers. Stuff that matters.
Re:All the Ganglia. The Nerves. On leaving a programming pro... by follower on Saturday July 07, 2012 @09:58PM (#4213311)
The single biggest thing that's helped me context switch between projects (or return to one) has been keeping a project log.

To me, a project log is to documentation as Twitter is to blogging--it requires little effort but over time provides useful pointers to where you were at the time.

Originally I used a "one way personal wiki" to keep track, like this: http://code.rancidbacon.com/ProjectLogArduinoUSB

But when I lost the server it was on I decided to re-implement it on Google App Engine and make it available to other people, thus was born Labradoc, here's an example project log: http://www.labradoc.com/i/follower/p/project-sms-text-scroll...

It's kinda a "commit log for your day".

Re:All the Ganglia. The Nerves. On leaving a programming pro... by trafficlight on Saturday July 07, 2012 @10:23PM (#4213364)
This is very cool. I hate coming back to a project a couple months later and having no idea what state things got left in.
Re:All the Ganglia. The Nerves. On leaving a programming pro... by follower on Sunday July 08, 2012 @07:38AM (#4214363)
Thanks. :)

Yeah, it's really helped with those "now, what was that command line I used?" and "how did I solve that problem last time?" type questions too.

And not just for yourself. It also helps other people pick up "incomplete" projects you might have lying around that you cough haven't got around to documenting yet.

Re:All the Ganglia. The Nerves. On leaving a programming pro... by blu3jack on Saturday July 07, 2012 @10:12PM (#4213331)
I like it. I have done some things like this in the past, but not in as much detail as yours. Very inspiring!
Re:All the Ganglia. The Nerves. On leaving a programming pro... by follower on Sunday July 08, 2012 @07:42AM (#4214369)
Cheers. :) I have to admit as much as I would like everyone to use Labradoc, inspiring other developers to get in the habit of writing public project logs is a prime objective too--whatever they use.

I started out with just writing single line entries but because they proved so useful it encouraged me to spend a little more time writing longer entries. (Although I often end up with a whole bunch of browser tabs open as a result. :) )

Re:All the Ganglia. The Nerves. On leaving a programming pro... by blu3jack on Sunday July 08, 2012 @11:02AM (#4214714)
When I've done it, I've done it as a status log at the bottom of the README, or in a separate file in the project. But I think your level of detail is just right: it doesn't look ridiculously time consuming, and yet it captures the real content & momentum of the project.