Doc fix

I fixed a bunch of documentation issues. You'll need to update your roxygen too. 
There are several placeholders for @params that you'll need to flesh out before shipping to CRAN
I updated my bio in the README and also turned functions into fixed width code.

Thanks for the update @SimonGoring. It would really help minimise issues if you didn't run your master branch out so far ahead of the ropensci upstream. Also, try to compartmentalise your commits to separate branches for separate fixes; when you merge you are going to pull in a lot of changes in one go, across the code base. At the moment this means either no-one can work on the package until you merge or people work on package and then have to battle merge conflicts.