add a lot of docs and a reference to them in the README