sentence too long; also fix grammar, and add markup
Merge pull request #770 from tshepang/split

sentence too long; also fix grammar, and add markup