Much better docs and description

Adds better description, makes the docs up to date and complete, adds some usage examples.