example clarification from pr #1