Minor documentation improvements

I improved some bits of documentation that, while reading the code, I thought could be better.