fairly finished version of readme notes