add lots of docs to the readme