updated notes for pending refactor