hide inner wrapper in decorators, add docstrings and improve README