Fix function comments based on best practices from Effective Go #235

CodeLingoBot wants to merge 1 commit intoant0ine:masterant0ine/go-json-rest:masterfrom

CodeLingoBot:rewriteCopy head branch name to clipboard