Improve docblocks

Couple of docblock and linting fixes.
When implementing an interface or overriding a method, I do this instead of copy/pasting. It's up to you.

Some projects use `@inheritDoc`, but I've had mixed results with it and this is more explicit, as any generator should create a hyperlink to the referenced doc block.