flesh out README

The README is now longer than the code itself(!)