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.