added notes and validation