Update README.markdown

Hopefully this is the start of improving documentation a bit