addition documentation and test utils