tidied up notes for github formatting