adding detailed description of return values
removing doc cruft that was specific to the web page we scraped
correcting typo
Merge pull request #29 from spaceappsatlanta/README

adding detailed description of return values