added package docstring and made the readme slightly more verbose
added note about no overhead decoration on params