I like sequence diagrams for understanding unfamiliar or complex code that I need to work with. Go in, head spins, make a sequence diagram, grok, then make you

I like sequence diagrams for understanding unfamiliar or complex code that I need to work with. Go in, head spins, make a sequence diagram, grok, then make your change. They're awesome for that, and they make decent notes later, but realistically they'll be out of date by the next time you look at them. I recommend plantuml for this: very friendly syntax, git friendly, and easy to regenerate over time as the code changes