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

No match.