clarifications for new examples