fix and clarify the READMEs