project-wide readme updated