clarify and expand run examples