Incomplete changes to the API
Add a real detailed README.
Rewrite it to be cleaner and more formal.