more comments/clarity in examples.