Codebase needs more comments

[novedevo]

We can deal with rustdoc later, but for now we need to add helpful comments in confusing areas. This is mostly my fault; most of my code tries to be self-documenting instead of using comments, but doesn't always succeed.