update README, correcting some instructions
update some dev docs