clean up @return documentation

Noticed a couple `@returns` instead of `@return` when I was working on something.. did some general spacing and punctuation cleanup while I was at it