added several examples and documentation