updated doc and examples