update READMEs and related code