added general comments. We probably want to document more before deadline?