add notes to examples