add examples and updates