Fix some of the formatting issues in the README

Specifically the line breaks and don't make lists includ everything
Add a bullet point on an item
Correct data for the stop route w/ location data
Add an example for the predictions route
Merge pull request #24 from MariusVolkhart/documentation2

API documentation fixes
Merge remote-tracking branch 'origin/master' into issue-8