Rewrote readme and improve api

I would need rubber duck debugging for the only test failing please :(
I can't see why it never receives a response :|
I'm actually happy to see this, I tend to forget the use of `.warn` and `.debug` in favor of `.log`.