Moved the top level documentation to markdown, updated some top level files
Updated the documentation