updating with notes to clarify examples