Clarifying the documentation

[damies13]

trafficstars

This PR is just trying to make some things in the documentation that I found weren't clear at first and had to look at the code to be sure. Not every user will have the ability to read and understand the code.