add more tests, fix outdated tests
begin (rudimentary) documentation of api