Improves the introduction further
Updates the markdown file and html