Updated docs

I have fixed some typos, grammatical errors and made some clarifications, keeping all the meaning.
Additionally I added lost language specifiers so that all code blocks would have proper syntax highlighting. Someday... when Codeception/codeception.github.com#27 will get fixed.
*Oh, and if somebody is viewing changes right here on Github, you can add `?w=1` to URL to ignore whitespaces.*