update docs and test suite