add the markdown and html file descriptions to readme