tweak documentation and tests