A similar idea I practice. After I solve a complex problem I usually leave a big comment at the top of the main file, explaining how I arrived at that solution,

A similar idea I practice. After I solve a complex problem I usually leave a big comment at the top of the main file, explaining how I arrived at that solution, the caveats, how it works, and how it interacts with other files and dependencies. If I need to, I also use Monodraw to produce ASCII character graphs and add them to the comment to explain concepts. It helps to cement the solution in your brain and it's a system of record on how it was accomplished in case you forget. I do this only for personal projects though. I don't think co-workers would appreciate an essay with exhibits at the top of a file, lol.