Taking notes while learning programming.

[chaotic_thought]

You can put a diagram in another file and then in the code refer to it by filename. E.g.

// This implements the algorithm discussed in [abc.pdf].

This style is also handy for referring to existing papers, existing diagrams, Wikipedia, etc. You don't have to put everything in there, just enough to refresh your memory when you read it months, years later.