Improve docblocks

Couple of docblock and linting fixes.
limit 10 skip 15 reads like a overflow and weird api.
also in sql it is "skip, limit" I think?