update examples and fix wording