added notes, started designing for refactor