add examples and comments