throw! with tests. fix documentation bug.
update readme
added changelog
bump up versionb
update README