new readme and methods 2