last-minute updates to readme and docs before refactoring them