readme clarifications and clean ups