my notes and cleanup from a first pass