more comprehensive readme, closes #6