add more explanation about why we did this, and show the full example. Also fix some missing punctuation.