examples and documentation improvements