more notes for the readme, and a new sample from John