Documentation updates

Just went through and added documentation for places that might be confusing.

All tests pass.