better readme example and details of how it works