added examples and documentation inline