documentation and test improvements