update readme with method signatures