more examples and documentation