Improve docblocks

Couple of docblock and linting fixes.
Unless we're defining an interface, it's good practice to use visibility keywords. Yes, I know `public` is the default :)