fix docs for the limit changes

Also noticed an extraneous phrase in the docs.
Merge pull request #529 from rackerlabs/auto-867-868-doc-limits

fix docs for the limit changes