Update and rename README.markdown to README.md

Mostly just documentation cleanup to use ruby markdown
and miscellaneous small updates.