added notes and documentation