@sydneyfalk that's why I also like types in languages. I can see what a function expects and returns without you writing docs for it and I don't have to read the function.
When I read or write code, I'm thinking in logical terms. I keep in memory a map of how this piece of code connects to the rest of the codebase, but when I read a comment, I have to switch to reading what the author though at that moment was the scope of that block of code.