fix md typo; fix spelling; clarifications