progress on README + a bit of code cleanup