updated examples and smarter grammar