examples: new examples and associated docs