fixed docs
added link
cleaned up docs, fixed web service method return structure
fixed text
fixed test
rearranged stuff
Merge pull request #81 from mozilla/doc-update-1

Doc update 1