Small Bit of Refactoring and Updating Documentation

I finally got @LtHummus to review this, and he found a few things awry.
I also made some clarifications in the comments.