added more examples in doc

describe in more detail how the library will be used