add notes on for-each, plus code examples