update api methods and doc; update readme; added changelog; updated test
merge readme