better tests; documentation; small refactor
doc bump