improve documentation (examples)