sentence too long; also fix grammar, and add markup