fix docs, tests & api to be simpler
1.0.0
1.0.1