comments, tidies, example improvements