[simonw]

Any time I'm working on some code I open a GitHub issue for it. I then make comments on that issue as I go, recording decisions I make and things I try and "next steps" I need to take and links to API documentation or example code that I need.

I try to ensure there's as little relevant information as possible that's exclusively in my head.

This means I can recover from an interruption - "get back in flow" - much faster than if I kept everything in my head.

More importantly, it means I can have an order of magnitude more projects on the go at once. I sometimes return to an issue I first opened more than a year ago and can productively start working on it with just a few minutes of review of the previous comments.