tidied up notes for github formatting
tidied up notes for github formatting