update readme.md with method descriptions