Adjusted some documentation

I'm new to the Pull Request system of github. I thought it would be good, to try it out with a small example. I adjusted some documentation which I thought was confusing. If you don't like these changes feel free to ignore them. :)