UTF8 encode url params

Fixes #67. 

Also included some missing docs while I was at it.