Spruced up documentation.
A couple of comments were sketchy. I spruced them up.