I think that if you want “what the code does”, detailed description in the commits is much better, since then you can at least see the snapshot with its origina

I think that if you want “what the code does”, detailed description in the commits is much better, since then you can at least see the snapshot with its original context. You can even go through a particular file’s associated changes to see how it’s morphed over time.