Move the doc files to end .md and also do some minor reformating to
make use of the Markdown format. This will make the docs more readable
on Github.