adding some notes and some cleanup