Let's clean up this documentation a little and add an `@since` tag. Usually it's params, examples, return, and see with a spacer line between the parts.