Updated the user guide.

Better documentation of job polling, plus some typos corrected, and clearer syntax highlight colours.

@matthewrmshin - please review.
We'll need to change these as well.