added some notes as encountered during usage