tidy up parameter documentation
Merge branch 'master' of github.com:gocardless/gc-http-factory