add more tests even for deprecated methods and fix some doc
improve doc and add a new contributor to the list
bump version