update README and helper classes