added notes and other other fixes