added a few more notes about the example