improve README and add test boilerplate