added examples and documentation