updated documents to show examples and use