updates to the readme markdown and html version