added doc and more examples