more updates/clarifications to README