update doc string + examples