Written hopefully exhaustive readme

Docs are longer than code :)