review and update readme /thanks @mrdavidlaing