new readme and methods