touch up examples and docs