added example and notes