re-write old doc/README to something more useful and up-to-date