suggest changes in Markdown files

reviewed quickly. accept any changes that make sense