documentation fixes

The docs had a few errors, and it made it more confusing.