add example to the documentation and tests
add example to the documentation and tests