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 :|
This is one of the most basic use cases, but that's not necessarily the only one (think about our daybed forms project).