fixes, decorators, new readme, other stuff