Making a lot of comments private.

- Also improving documentation.
- Improved a test to use a better assertion.
Clearing up some code smells.