initial populating of README

Full speed ahead
Fixed markdown
merging luzpaz work plus some more notes