small README tweaks
re-organize code into separate passes