Improve docblocks

Couple of docblock and linting fixes.
Because we'll then end up with the "if 32bit? code-rot else tested code that we know how works"
It better be a consistent thing imo.

Why should it be an integer anyway? Will it always be an int in the future? can't it just as well be mongoid? Or something that can be traced back to the particular server/shard?