address yry comments, add examples