add more doc details, some more examples