converge documentation and examples (and test)