add some notes and structure