added docs and examples