clarify the READMEs

and update a little bit the config files