update README and some documentation