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 :|
Or we should bind all the time, but I'm myself not very clear as to what's my preferred approach. In any case, we should try to be consistent.