significant cleanup, reformatting of the markdown

clean up, spelling and grammar corrections, typo corrections and
markdown formatting error corrections.