added doc and examples