more notes for someone jumping in to playing with this repo