Improve docblocks

Couple of docblock and linting fixes.
Typo on my part. That should have been `@see`.