Improve docblocks

Couple of docblock and linting fixes.
I was referring to the object, not the variable :)