added notes and tests