clearer method + readme