I think the more useful side to this is that the path to understanding a codebase or library is in some ways like understanding a literary work. It takes some

I think the more useful side to this is that the path to understanding a codebase or library is in some ways like understanding a literary work. It takes some time, rereading a bit. discussing it with other people who are reading it, making the right amount of notes in the margin, consulting the dictionary when you don't understand a term. If it's in a language you don't know, you can translate it slowly, but knowing the basics goes a long way. I like this way of looking at it because it has more to do with gaining understanding than with promoting some semantic style in regards to documenting