More comments, with examples

A look at how the suite works.