Renamed README files to README.md files.

Renamed README and doc/README to README.md and  doc/README.md and edited contents to adhere to github markdown format.
Merge branch 'readme-to-markdown' of github.com:urbanslug/haddock into readme-to-markdown

Amended commit to include updating of doc/README to markdown